runmat 0.5.7-dev.2 → 0.5.7-dev.4

package/dist/generated/builtins/inputParser.js

@@ -0,0 +1,71 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "inputParser",
+    "category": "introspection",
+    "keywords": [
+        "inputParser",
+        "addParameter",
+        "parse",
+        "name-value",
+        "varargin"
+    ],
+    "summary": "Parse MATLAB-style optional name-value arguments.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "inputParser stores host-side metadata and parsed values."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::introspection::input_parser::tests",
+        "integration": "runmat-vm inputParser tests"
+    },
+    "description": "`inputParser` creates a handle object for parsing common MATLAB name-value argument patterns. RunMat supports the minimal workflow used by imported helper functions: create a parser, register parameters with defaults, parse `varargin{:}`, and read values from `p.Results`.",
+    "behaviors": [
+        "`p = inputParser` returns a handle object with an initially empty `Results` struct.",
+        "`addParameter(p, name, default)` registers a case-sensitive name and default value, mutating `p` in place.",
+        "`parse(p, name, value, ...)` starts from the registered defaults and applies exact name matches.",
+        "`p.Results.<name>` reads the parsed value for a registered parameter.",
+        "Duplicate parameter names, odd name-value argument counts, non-text names, and unknown parsed names raise stable RunMat errors.",
+        "This compatibility slice does not yet implement `addRequired`, `addOptional`, validators, `CaseSensitive`, `PartialMatching`, `KeepUnmatched`, or `StructExpand`."
+    ],
+    "examples": [
+        {
+            "description": "Parse an optional scale parameter",
+            "input": "function y = f(varargin)\n  p = inputParser;\n  addParameter(p, 'scale', 2);\n  parse(p, varargin{:});\n  y = p.Results.scale;\nend\n\nf('scale', 4)",
+            "output": "ans =\n     4"
+        },
+        {
+            "description": "Use a registered default when the name is omitted",
+            "input": "p = inputParser;\naddParameter(p, 'scale', 2);\nparse(p);\np.Results.scale",
+            "output": "ans =\n     2"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Are parameter names case-sensitive?",
+            "answer": "Yes. This initial RunMat implementation uses exact case-sensitive name matching."
+        },
+        {
+            "question": "Does RunMat support validators or positional arguments?",
+            "answer": "Not yet. The current support is intentionally limited to optional name-value parameters registered with `addParameter`."
+        }
+    ],
+    "key": "inputparser",
+    "slug": "inputparser",
+    "aliases": [],
+    "categoryPath": [
+        "introspection"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=inputParser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputParser.js","sourceRoot":"","sources":["../../../src/generated/builtins/inputParser.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,aAAa;QACb,cAAc;QACd,OAAO;QACP,YAAY;QACZ,UAAU;KACX;IACD,SAAS,EAAE,mDAAmD;IAC9D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0DAA0D;KACpE;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,8CAA8C;QACtD,aAAa,EAAE,6BAA6B;KAC7C;IACD,aAAa,EAAE,kRAAkR;IACjS,WAAW,EAAE;QACX,qFAAqF;QACrF,4GAA4G;QAC5G,kGAAkG;QAClG,uEAAuE;QACvE,iIAAiI;QACjI,mKAAmK;KACpK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,sJAAsJ;YAC/J,QAAQ,EAAE,eAAe;SAC1B;QACD;YACE,aAAa,EAAE,mDAAmD;YAClE,OAAO,EAAE,4EAA4E;YACrF,QAAQ,EAAE,eAAe;SAC1B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,kFAAkF;SAC7F;QACD;YACE,UAAU,EAAE,yDAAyD;YACrE,QAAQ,EAAE,yHAAyH;SACpI;KACF;IACD,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

@@ -0,0 +1,95 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "insertAfter",
+    "category": "strings/transform",
+    "keywords": [
+        "insertAfter",
+        "strings",
+        "transform",
+        "matlab",
+        "compatibility"
+    ],
+    "summary": "Insert text after a position or boundary.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "No GPU kernel is registered for this compatibility builtin; GPU-resident inputs are gathered to host memory before evaluation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": null,
+        "constants": "not applicable",
+        "notes": "Not eligible for fusion; this builtin materializes host text or logical results."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::strings::transform::compat::tests",
+        "integration": null
+    },
+    "description": "s = insertAfter(text, boundary, newText) - Insert text after a position or boundary.",
+    "signatures": [
+        {
+            "label": "s = insertAfter(text, boundary, newText)",
+            "inputs": [
+                {
+                    "name": "text",
+                    "ty": "Any",
+                    "arity": "Required",
+                    "default": null,
+                    "description": "Input text."
+                },
+                {
+                    "name": "arg",
+                    "ty": "Any",
+                    "arity": "Variadic",
+                    "default": null,
+                    "description": "Additional arguments."
+                }
+            ],
+            "outputs": [
+                {
+                    "name": "out",
+                    "ty": "Any",
+                    "arity": "Required",
+                    "default": null,
+                    "description": "Output value."
+                }
+            ]
+        }
+    ],
+    "behaviors": [
+        "Insert text after a position or boundary.",
+        "Numeric boundaries are 1-based character positions and missing boundaries are reported as errors."
+    ],
+    "examples": [
+        "insertAfter(\"run\", 3, \"mat\") returns \"runmat\"."
+    ],
+    "faqs": [],
+    "links": [
+        {
+            "label": "string",
+            "url": "./string"
+        },
+        {
+            "label": "char",
+            "url": "./char"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/strings/transform/compat.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/transform/compat.rs"
+    },
+    "key": "insertafter",
+    "slug": "insertafter",
+    "aliases": [],
+    "categoryPath": [
+        "strings",
+        "transform"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=insertAfter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"insertAfter.js","sourceRoot":"","sources":["../../../src/generated/builtins/insertAfter.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,aAAa;QACb,SAAS;QACT,WAAW;QACX,QAAQ;QACR,eAAe;KAChB;IACD,SAAS,EAAE,2CAA2C;IACtD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gIAAgI;KAC1I;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,kFAAkF;KAC5F;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,6CAA6C;QACrD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,sFAAsF;IACrG,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE;gBACR;oBACE,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,aAAa;iBAC7B;gBACD;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,uBAAuB;iBACvC;aACF;YACD,SAAS,EAAE;gBACT;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,eAAe;iBAC/B;aACF;SACF;KACF;IACD,WAAW,EAAE;QACX,2CAA2C;QAC3C,mGAAmG;KACpG;IACD,UAAU,EAAE;QACV,sDAAsD;KACvD;IACD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,WAAW;KACZ;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

@@ -0,0 +1,95 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "insertBefore",
+    "category": "strings/transform",
+    "keywords": [
+        "insertBefore",
+        "strings",
+        "transform",
+        "matlab",
+        "compatibility"
+    ],
+    "summary": "Insert text before a position or boundary.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "No GPU kernel is registered for this compatibility builtin; GPU-resident inputs are gathered to host memory before evaluation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": null,
+        "constants": "not applicable",
+        "notes": "Not eligible for fusion; this builtin materializes host text or logical results."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::strings::transform::compat::tests",
+        "integration": null
+    },
+    "description": "s = insertBefore(text, boundary, newText) - Insert text before a position or boundary.",
+    "signatures": [
+        {
+            "label": "s = insertBefore(text, boundary, newText)",
+            "inputs": [
+                {
+                    "name": "text",
+                    "ty": "Any",
+                    "arity": "Required",
+                    "default": null,
+                    "description": "Input text."
+                },
+                {
+                    "name": "arg",
+                    "ty": "Any",
+                    "arity": "Variadic",
+                    "default": null,
+                    "description": "Additional arguments."
+                }
+            ],
+            "outputs": [
+                {
+                    "name": "out",
+                    "ty": "Any",
+                    "arity": "Required",
+                    "default": null,
+                    "description": "Output value."
+                }
+            ]
+        }
+    ],
+    "behaviors": [
+        "Insert text before a position or boundary.",
+        "Numeric boundaries are 1-based character positions and missing boundaries are reported as errors."
+    ],
+    "examples": [
+        "insertBefore(\"run\", 1, \"pre\") returns \"prerun\"."
+    ],
+    "faqs": [],
+    "links": [
+        {
+            "label": "string",
+            "url": "./string"
+        },
+        {
+            "label": "char",
+            "url": "./char"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/strings/transform/compat.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/transform/compat.rs"
+    },
+    "key": "insertbefore",
+    "slug": "insertbefore",
+    "aliases": [],
+    "categoryPath": [
+        "strings",
+        "transform"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=insertBefore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"insertBefore.js","sourceRoot":"","sources":["../../../src/generated/builtins/insertBefore.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,cAAc;QACd,SAAS;QACT,WAAW;QACX,QAAQ;QACR,eAAe;KAChB;IACD,SAAS,EAAE,4CAA4C;IACvD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gIAAgI;KAC1I;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,kFAAkF;KAC5F;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,6CAA6C;QACrD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,wFAAwF;IACvG,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE;gBACR;oBACE,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,aAAa;iBAC7B;gBACD;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,uBAAuB;iBACvC;aACF;YACD,SAAS,EAAE;gBACT;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,eAAe;iBAC/B;aACF;SACF;KACF;IACD,WAAW,EAAE;QACX,4CAA4C;QAC5C,mGAAmG;KACpG;IACD,UAAU,EAAE;QACV,uDAAuD;KACxD;IACD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,WAAW;KACZ;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/int2str.js

@@ -0,0 +1,124 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "int2str",
+    "category": "strings/core",
+    "keywords": [
+        "int2str",
+        "integer to string",
+        "number to string",
+        "round",
+        "gpu"
+    ],
+    "summary": "Convert rounded integer values to a character array in MATLAB and RunMat.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Accepts GPU tensors but gathers them to host memory before rounding and formatting."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::strings::core::int2str::tests",
+        "integration": "builtins::strings::core::int2str::tests::int2str_gpu_tensor_roundtrip"
+    },
+    "description": "`int2str(N)` treats `N` as a numeric or logical scalar, vector, or matrix, rounds floating-point values to integers, and returns a MATLAB `char` array.",
+    "behaviors": [
+        "Floating-point values are rounded before conversion.",
+        "Scalar and vector inputs return one text row; matrix inputs return one character row per numeric row.",
+        "Columns are padded with spaces so each textual column aligns across rows.",
+        "Logical and integer inputs are accepted and formatted as numeric 0/1 or integer values.",
+        "GPU tensors are gathered to host memory before formatting.",
+        "Empty inputs return a `0x0` character array.",
+        "Complex inputs, inputs with more than two dimensions, and non-numeric inputs raise descriptive errors."
+    ],
+    "examples": [
+        {
+            "description": "Convert An Integer",
+            "input": "chr = int2str(256)",
+            "output": "chr =\n    '256'"
+        },
+        {
+            "description": "Round A Floating-Point Value",
+            "input": "chr = int2str(3.14159)",
+            "output": "chr =\n    '3'"
+        },
+        {
+            "description": "Format A Numeric Matrix",
+            "input": "chr = int2str([5 10 20; 100 200 400])",
+            "output": "chr =\n    '  5   10   20'\n    '100  200  400'"
+        },
+        {
+            "description": "Convert GPU-Resident Data",
+            "input": "G = gpuArray([10.2 20.8]);\nchr = int2str(G)",
+            "output": "chr =\n    '10  21'"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How is `int2str` different from `num2str`?",
+            "answer": "`int2str` rounds numeric values to integers first and has no precision or format-string arguments. Use `num2str` when you need decimal formatting or explicit `printf`-style control."
+        },
+        {
+            "question": "Does `int2str` return a modern string scalar?",
+            "answer": "No. MATLAB `int2str` returns a character array. Wrap the result with `string(...)` if you need a string scalar."
+        },
+        {
+            "question": "Does `int2str` run on the GPU?",
+            "answer": "No. GPU inputs are accepted, gathered to host memory, and formatted on the CPU, matching MATLAB's documented GPU-array limitation."
+        },
+        {
+            "question": "Does `int2str` support complex inputs?",
+            "answer": "No. RunMat rejects complex inputs for `int2str` because MATLAB documents the input as a numeric matrix of integer values and does not document complex formatting for this function."
+        }
+    ],
+    "links": [
+        {
+            "label": "num2str",
+            "url": "./num2str"
+        },
+        {
+            "label": "sprintf",
+            "url": "./sprintf"
+        },
+        {
+            "label": "string",
+            "url": "./string"
+        },
+        {
+            "label": "char",
+            "url": "./char"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/strings/core/int2str.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/core/int2str.rs"
+    },
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "chr = int2str(N)"
+        },
+        "points": [
+            "`N` is a numeric or logical scalar, vector, or matrix.",
+            "Floating-point values are rounded before text conversion.",
+            "Returns `chr`, a MATLAB `char` array with matrix columns padded for alignment."
+        ]
+    },
+    "key": "int2str",
+    "slug": "int2str",
+    "aliases": [],
+    "categoryPath": [
+        "strings",
+        "core"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=int2str.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"int2str.js","sourceRoot":"","sources":["../../../src/generated/builtins/int2str.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,SAAS;QACT,mBAAmB;QACnB,kBAAkB;QAClB,OAAO;QACP,KAAK;KACN;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,qFAAqF;KAC/F;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,aAAa,EAAE,uEAAuE;KACvF;IACD,aAAa,EAAE,yJAAyJ;IACxK,WAAW,EAAE;QACX,sDAAsD;QACtD,uGAAuG;QACvG,2EAA2E;QAC3E,yFAAyF;QACzF,4DAA4D;QAC5D,8CAA8C;QAC9C,wGAAwG;KACzG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oBAAoB;YACnC,OAAO,EAAE,oBAAoB;YAC7B,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,wBAAwB;YACjC,QAAQ,EAAE,gBAAgB;SAC3B;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,iDAAiD;SAC5D;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,qBAAqB;SAChC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,uLAAuL;SAClM;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,oIAAoI;SAC/I;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,sLAAsL;SACjM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,kBAAkB;SAC5B;QACD,QAAQ,EAAE;YACR,wDAAwD;YACxD,2DAA2D;YAC3D,gFAAgF;SACjF;KACF;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,MAAM;KACP;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/interp1.js

@@ -20,7 +20,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "matlab",
-        "notes": "GPU inputs are gathered to the CPU reference implementation in this release. Linear and nearest interpolation are good future provider-kernel candidates."
+        "notes": "Linear and nearest interpolation keep real resident Y/query data on the active provider when sample points are implicit or host-validated. Spline/pchip forms, complex data, provider-missing cases, and resident X breakpoint validation fall back to the host path."
     },
     "fusion": {
         "elementwise": false,
@@ -33,7 +33,7 @@ const builtinDoc = {
         "`interp1(y, xq)` uses implicit sample points `1:numel(y)`.",
         "`interp1(x, y, xq, method)` supports `linear`, `nearest`, `spline`, and `pchip`.",
         "Out-of-range query points return `NaN` unless an extrapolation value or `'extrap'` is supplied.",
-        "Dense real numeric arrays are supported. GPU inputs gather to the host reference path."
+        "Dense real numeric arrays are supported. Real gpuArray Y/query inputs stay resident for linear and nearest interpolation when X is implicit or host-validated."
     ],
     "examples": [
         {
@@ -45,6 +45,11 @@ const builtinDoc = {
             "description": "Spline interpolation",
             "input": "x = [1 2 3];\ny = [1 4 9];\nyq = interp1(x, y, [1.5 2.5], 'spline')",
             "output": "yq = [2.25 6.25]"
+        },
+        {
+            "description": "Resident GPU linear interpolation",
+            "input": "Y = gpuArray([10 20 40]);\nVq = interp1(Y, gpuArray([1.5 2.5]))",
+            "output": "Vq = gpuArray([15 30])"
         }
     ],
     "syntax": {
@@ -78,6 +83,7 @@ const builtinDoc = {
         "label": "Open an issue",
         "url": "https://github.com/runmat-org/runmat/issues/new/choose"
     },
+    "gpu_residency": "`interp1` uploads implicit or host-validated sample points, evaluates linear/nearest queries with provider `interp1`, and returns a resident gpuArray output. Spline, pchip, complex, and resident-X validation paths use the host implementation until dedicated validation/interpolation kernels cover those cases.",
     "key": "interp1",
     "slug": "interp1",
     "aliases": [],

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

@@ -1 +1 @@
-{"version":3,"file":"interp1.js","sourceRoot":"","sources":["../../../src/generated/builtins/interp1.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,SAAS;QACT,eAAe;QACf,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,OAAO;KACR;IACD,SAAS,EAAE,gEAAgE;IAC3E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,2JAA2J;KACrK;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,aAAa,EAAE,0NAA0N;IACzO,WAAW,EAAE;QACX,4DAA4D;QAC5D,kFAAkF;QAClF,iGAAiG;QACjG,wFAAwF;KACzF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,8DAA8D;YACvE,QAAQ,EAAE,cAAc;SACzB;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,qEAAqE;YAC9E,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,uHAAuH;SACjI;QACD,QAAQ,EAAE;YACR,kGAAkG;YAClG,mIAAmI;YACnI,oGAAoG;YACpG,qFAAqF;YACrF,2GAA2G;SAC5G;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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,eAAe;QACxB,KAAK,EAAE,wDAAwD;KAChE;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"interp1.js","sourceRoot":"","sources":["../../../src/generated/builtins/interp1.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,SAAS;QACT,eAAe;QACf,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,OAAO;KACR;IACD,SAAS,EAAE,gEAAgE;IAC3E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,uQAAuQ;KACjR;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,aAAa,EAAE,0NAA0N;IACzO,WAAW,EAAE;QACX,4DAA4D;QAC5D,kFAAkF;QAClF,iGAAiG;QACjG,gKAAgK;KACjK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,8DAA8D;YACvE,QAAQ,EAAE,cAAc;SACzB;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,qEAAqE;YAC9E,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,iEAAiE;YAC1E,QAAQ,EAAE,wBAAwB;SACnC;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,uHAAuH;SACjI;QACD,QAAQ,EAAE;YACR,kGAAkG;YAClG,mIAAmI;YACnI,oGAAoG;YACpG,qFAAqF;YACrF,2GAA2G;SAC5G;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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,eAAe;QACxB,KAAK,EAAE,wDAAwD;KAChE;IACD,eAAe,EAAE,uTAAuT;IACxU,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/interp1q.js

@@ -0,0 +1,79 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "interp1q",
+    "category": "math/interpolation",
+    "keywords": [
+        "interp1q",
+        "interpolation",
+        "linear",
+        "legacy"
+    ],
+    "summary": "Legacy quick one-dimensional linear interpolation.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "gpuArray inputs are gathered to the CPU linear interpolation implementation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::interpolation::interp1q::tests",
+        "integration": null
+    },
+    "description": "`interp1q(X,V,Xq)` is the legacy quick form of one-dimensional linear interpolation. It uses strictly increasing sample points and returns `NaN` for out-of-range query points.",
+    "behaviors": [
+        "Accepts exactly three inputs: sample locations `X`, sample values `V`, and query locations `Xq`.",
+        "`X` must be a finite strictly increasing vector with at least two points.",
+        "`V` must be real or complex numeric data compatible with `X` using the same sample-dimension rules as `interp1`; complex values interpolate real and imaginary parts independently.",
+        "Complex `X` and `Xq` inputs are accepted when their imaginary parts are zero; interpolation coordinates must be real-valued and strictly increasing.",
+        "Vector-valued queries preserve scalar versus array shape for vector `V`; matrix `V` returns `numel(Xq)` by trailing-series dimensions.",
+        "Only linear interpolation is supported, matching the legacy quick-interpolation API."
+    ],
+    "examples": [
+        {
+            "description": "Linear interpolation",
+            "input": "vq = interp1q([1 2 3], [10 20 40], [1.5 2.5])",
+            "output": "vq = [15 30]"
+        },
+        {
+            "description": "Out-of-range query",
+            "input": "vq = interp1q([1 2], [10 20], 3)",
+            "output": "vq = NaN"
+        },
+        {
+            "description": "Complex sample values",
+            "input": "vq = interp1q([1 2 3], [10+1i 20+3i 40+7i], [1.5 2.5])",
+            "output": "vq = [15+2i 30+5i]"
+        }
+    ],
+    "links": [
+        {
+            "label": "interp1",
+            "url": "./interp1"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/interpolation/interp1q.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/interpolation/interp1q.rs"
+    },
+    "key": "interp1q",
+    "slug": "interp1q",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "interpolation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=interp1q.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interp1q.js","sourceRoot":"","sources":["../../../src/generated/builtins/interp1q.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,UAAU;QACV,eAAe;QACf,QAAQ;QACR,QAAQ;KACT;IACD,SAAS,EAAE,oDAAoD;IAC/D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,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,MAAM,EAAE,gDAAgD;QACxD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,iLAAiL;IAChM,WAAW,EAAE;QACX,kGAAkG;QAClG,2EAA2E;QAC3E,qLAAqL;QACrL,sJAAsJ;QACtJ,wIAAwI;QACxI,sFAAsF;KACvF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,+CAA+C;YACxD,QAAQ,EAAE,cAAc;SACzB;QACD;YACE,aAAa,EAAE,oBAAoB;YACnC,OAAO,EAAE,kCAAkC;YAC3C,QAAQ,EAAE,UAAU;SACrB;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,wDAAwD;YACjE,QAAQ,EAAE,oBAAoB;SAC/B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qEAAqE;QAC9E,KAAK,EAAE,kHAAkH;KAC1H;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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