runmat 0.4.5-dev.2 → 0.4.5-dev.4

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

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

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

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

package/dist/generated/builtins/imshow.js

@@ -0,0 +1,104 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "imshow",
+    "category": "plotting",
+    "keywords": [
+        "imshow",
+        "image display",
+        "grayscale image",
+        "binary image",
+        "rgb image",
+        "matlab imshow"
+    ],
+    "summary": "Display grayscale, binary, truecolor, or file-backed images.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`imshow` is a plotting sink and does not advertise precision-specialized GPU kernels. Grayscale gpuArray inputs may use the image/surface rendering path; filename decoding and truecolor normalization run on the host."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::imshow::tests"
+    },
+    "description": "`imshow` displays image data using MATLAB-familiar defaults. Numeric and logical 2-D arrays render as grayscale images, MxNx3 and MxNx4 arrays render as truecolor images, and filename inputs are decoded through RunMat's filesystem layer before display.",
+    "behaviors": [
+        "`imshow(I)` displays 2-D numeric data with grayscale limits `[0, 1]`, matching MATLAB double-image defaults.",
+        "`imshow(BW)` displays logical image data as black and white using `[0, 1]` limits.",
+        "`imshow(RGB)` displays MxNx3 truecolor data directly.",
+        "`imshow(RGBA)` displays MxNx4 truecolor data with alpha.",
+        "`imshow(I, [low high])` displays grayscale image data using an explicit display range.",
+        "`imshow(I, [])` auto-scales grayscale image data from finite minimum to finite maximum.",
+        "`imshow(filename)` reads and decodes an image file, then displays it as truecolor data."
+    ],
+    "examples": [
+        {
+            "description": "Display a simple grayscale image",
+            "input": "row = 100;\ncol = 100;\nrsm = ones(row, col);\nimshow(rsm);"
+        },
+        {
+            "description": "Auto-scale a matrix for display",
+            "input": "A = peaks(128);\nimshow(A, []);"
+        },
+        {
+            "description": "Display truecolor RGB data",
+            "input": "R = ones(64, 64);\nG = zeros(64, 64);\nB = zeros(64, 64);\nRGB = cat(3, R, G, B);\nimshow(RGB);"
+        },
+        {
+            "description": "Display an image file",
+            "input": "imshow(\"photo.png\");"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What display range does imshow use for doubles?",
+            "answer": "`imshow(I)` uses `[0, 1]` for floating-point grayscale data. Use `imshow(I, [])` when you want RunMat to scale the visible range from the data minimum to maximum."
+        },
+        {
+            "question": "Does imshow support uint8 and uint16 image defaults?",
+            "answer": "File-backed images decode with byte pixel semantics. User-created integer image arrays currently depend on RunMat's broader numeric-class metadata model, so exact MATLAB class-dependent defaults for dense uint8/uint16 tensors are tracked separately."
+        },
+        {
+            "question": "How is imshow different from imagesc?",
+            "answer": "`imshow` is for image display and uses grayscale or truecolor image defaults. `imagesc` is for scaled matrix visualization and maps data through the active colormap."
+        }
+    ],
+    "links": [
+        {
+            "label": "image",
+            "url": "./image"
+        },
+        {
+            "label": "imagesc",
+            "url": "./imagesc"
+        },
+        {
+            "label": "colormap",
+            "url": "./colormap"
+        },
+        {
+            "label": "axis",
+            "url": "./axis"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/imshow.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/imshow.rs"
+    },
+    "key": "imshow",
+    "slug": "imshow",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=imshow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"imshow.js","sourceRoot":"","sources":["../../../src/generated/builtins/imshow.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,iBAAiB;QACjB,cAAc;QACd,WAAW;QACX,eAAe;KAChB;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,0NAA0N;KACpO;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,mCAAmC;KAC5C;IACD,aAAa,EAAE,8PAA8P;IAC7Q,WAAW,EAAE;QACX,8GAA8G;QAC9G,oFAAoF;QACpF,uDAAuD;QACvD,0DAA0D;QAC1D,wFAAwF;QACxF,yFAAyF;QACzF,yFAAyF;KAC1F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,6DAA6D;SACvE;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,iCAAiC;SAC3C;QACD;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,iGAAiG;SAC3G;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,wBAAwB;SAClC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,oKAAoK;SAC/K;QACD;YACE,UAAU,EAAE,sDAAsD;YAClE,QAAQ,EAAE,2PAA2P;SACtQ;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,uKAAuK;SAClL;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,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/interp1.d.ts

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

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

@@ -0,0 +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"}

package/dist/generated/builtins/interp1.js

@@ -0,0 +1,90 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "interp1",
+    "category": "math/interpolation",
+    "keywords": [
+        "interp1",
+        "interpolation",
+        "linear",
+        "nearest",
+        "spline",
+        "pchip"
+    ],
+    "summary": "Interpolate one-dimensional sampled data at query points.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "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."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "description": "`interp1(x, y, xq)` estimates values of a one-dimensional data set at query points `xq`. The default method is linear interpolation; `nearest`, `spline`, and `pchip` are also accepted.",
+    "behaviors": [
+        "`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."
+    ],
+    "examples": [
+        {
+            "description": "Linear interpolation",
+            "input": "x = [1 2 3];\ny = [10 20 40];\nyq = interp1(x, y, [1.5 2.5])",
+            "output": "yq = [15 30]"
+        },
+        {
+            "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]"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "yq = interp1(y, xq)\nyq = interp1(x, y, xq)\nyq = interp1(x, y, xq, method)\nyq = interp1(x, y, xq, method, 'extrap')"
+        },
+        "points": [
+            "`x` is a strictly increasing vector of sample locations. When omitted, RunMat uses `1:numel(y)`.",
+            "`y` contains the sampled values. Vector inputs produce vector outputs; matrix inputs are interpolated along the sample dimension.",
+            "`xq` contains query points. Scalar queries return scalars, and array queries preserve their shape.",
+            "`method` may be `linear`, `nearest`, `spline`, or `pchip`. The default is `linear`.",
+            "Out-of-range queries return `NaN` by default. Pass `'extrap'` to extrapolate or pass a scalar fill value."
+        ]
+    },
+    "links": [
+        {
+            "label": "spline",
+            "url": "./spline"
+        },
+        {
+            "label": "pchip",
+            "url": "./pchip"
+        },
+        {
+            "label": "interp2",
+            "url": "./interp2"
+        }
+    ],
+    "source": {
+        "label": "Open an issue",
+        "url": "https://github.com/runmat-org/runmat/issues/new/choose"
+    },
+    "key": "interp1",
+    "slug": "interp1",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "interpolation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=interp1.js.map

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

@@ -0,0 +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,2DAA2D;IACtE,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,0LAA0L;IACzM,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"}

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

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

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

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

@@ -0,0 +1,88 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "interp2",
+    "category": "math/interpolation",
+    "keywords": [
+        "interp2",
+        "2-D interpolation",
+        "bilinear",
+        "nearest",
+        "meshgrid"
+    ],
+    "summary": "Interpolate values over a two-dimensional gridded surface.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "GPU inputs are gathered to the CPU reference implementation in this release. Bilinear and nearest interpolation are intended future provider-kernel targets."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 5,
+        "constants": "inline"
+    },
+    "description": "`interp2(X, Y, Z, Xq, Yq)` estimates surface values at query points from gridded data. Vector axes and meshgrid-style coordinate matrices are accepted. `interp2(Z, Xq, Yq)` uses implicit axes based on the rows and columns of `Z`.",
+    "behaviors": [
+        "Supports `linear` and `nearest` methods in the initial implementation.",
+        "Out-of-range query points return `NaN` unless an extrapolation value or `'extrap'` is supplied.",
+        "Dense real numeric inputs are supported. GPU inputs gather to the host reference path."
+    ],
+    "examples": [
+        {
+            "description": "Bilinear interpolation with implicit axes",
+            "input": "Z = [1 2; 3 4];\nzq = interp2(Z, 1.5, 1.5)",
+            "output": "zq = 2.5"
+        },
+        {
+            "description": "Interpolation with meshgrid axes",
+            "input": "[X, Y] = meshgrid([10 20], [100 200]);\nZ = [1 2; 3 4];\nzq = interp2(X, Y, Z, 15, 150)",
+            "output": "zq = 2.5"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "Zq = interp2(Z, Xq, Yq)\nZq = interp2(X, Y, Z, Xq, Yq)\nZq = interp2(X, Y, Z, Xq, Yq, method)"
+        },
+        "points": [
+            "`Z` is a dense 2-D matrix of sampled surface values.",
+            "`X` and `Y` may be vector axes or meshgrid-style coordinate matrices matching `Z`. When omitted, implicit column and row axes are used.",
+            "`Xq` and `Yq` are scalar or same-size query arrays. Scalar queries broadcast against array queries.",
+            "`method` may be `linear` or `nearest` in the initial implementation. The default is `linear`.",
+            "Out-of-range queries return `NaN` by default. Pass `'extrap'` to extrapolate or pass a scalar fill value."
+        ]
+    },
+    "links": [
+        {
+            "label": "interp1",
+            "url": "./interp1"
+        },
+        {
+            "label": "meshgrid",
+            "url": "./meshgrid"
+        },
+        {
+            "label": "peaks",
+            "url": "./peaks"
+        }
+    ],
+    "source": {
+        "label": "Open an issue",
+        "url": "https://github.com/runmat-org/runmat/issues/new/choose"
+    },
+    "key": "interp2",
+    "slug": "interp2",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "interpolation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=interp2.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interp2.js","sourceRoot":"","sources":["../../../src/generated/builtins/interp2.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,mBAAmB;QACnB,UAAU;QACV,SAAS;QACT,UAAU;KACX;IACD,SAAS,EAAE,4DAA4D;IACvE,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,8JAA8J;KACxK;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,aAAa,EAAE,uOAAuO;IACtP,WAAW,EAAE;QACX,wEAAwE;QACxE,iGAAiG;QACjG,wFAAwF;KACzF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,4CAA4C;YACrD,QAAQ,EAAE,UAAU;SACrB;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,yFAAyF;YAClG,QAAQ,EAAE,UAAU;SACrB;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,+FAA+F;SACzG;QACD,QAAQ,EAAE;YACR,sDAAsD;YACtD,yIAAyI;YACzI,qGAAqG;YACrG,+FAA+F;YAC/F,2GAA2G;SAC5G;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,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;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"}

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

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

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

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

package/dist/generated/builtins/pchip.js

@@ -0,0 +1,78 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "pchip",
+    "category": "math/interpolation",
+    "keywords": [
+        "pchip",
+        "piecewise cubic hermite",
+        "shape preserving",
+        "interpolation"
+    ],
+    "summary": "Shape-preserving piecewise cubic Hermite interpolation.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "GPU inputs are gathered to the CPU reference implementation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "description": "`pchip(x, y)` builds a shape-preserving cubic Hermite interpolant. `pchip(x, y, xq)` evaluates it at query points.",
+    "behaviors": [
+        "Returns the same pp-structure shape used by `spline`.",
+        "Uses monotonicity-preserving slopes so monotone data does not overshoot between samples.",
+        "Dense real numeric inputs are supported in the initial implementation."
+    ],
+    "examples": [
+        {
+            "description": "Shape-preserving interpolation",
+            "input": "x = [1 2 3];\ny = [1 4 9];\nyq = pchip(x, y, [1.5 2.5])",
+            "output": "yq = [2.21875 6.21875]"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "pp = pchip(x, y)\nyq = pchip(x, y, xq)"
+        },
+        "points": [
+            "`x` is a strictly increasing vector of sample locations.",
+            "`y` contains the sampled values to interpolate.",
+            "`pchip(x, y)` returns a piecewise-polynomial structure compatible with `ppval`.",
+            "`pchip(x, y, xq)` evaluates the shape-preserving interpolant directly at query points.",
+            "PCHIP is usually preferred over spline interpolation when monotonicity and avoiding overshoot matter."
+        ]
+    },
+    "links": [
+        {
+            "label": "interp1",
+            "url": "./interp1"
+        },
+        {
+            "label": "ppval",
+            "url": "./ppval"
+        }
+    ],
+    "source": {
+        "label": "Open an issue",
+        "url": "https://github.com/runmat-org/runmat/issues/new/choose"
+    },
+    "key": "pchip",
+    "slug": "pchip",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "interpolation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=pchip.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pchip.js","sourceRoot":"","sources":["../../../src/generated/builtins/pchip.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,OAAO;QACP,yBAAyB;QACzB,kBAAkB;QAClB,eAAe;KAChB;IACD,SAAS,EAAE,yDAAyD;IACpE,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,8DAA8D;KACxE;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,aAAa,EAAE,oHAAoH;IACnI,WAAW,EAAE;QACX,uDAAuD;QACvD,0FAA0F;QAC1F,wEAAwE;KACzE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yDAAyD;YAClE,QAAQ,EAAE,wBAAwB;SACnC;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,wCAAwC;SAClD;QACD,QAAQ,EAAE;YACR,0DAA0D;YAC1D,iDAAiD;YACjD,iFAAiF;YACjF,wFAAwF;YACxF,uGAAuG;SACxG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,wDAAwD;KAChE;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/ppval.js

@@ -0,0 +1,77 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "ppval",
+    "category": "math/interpolation",
+    "keywords": [
+        "ppval",
+        "piecewise polynomial",
+        "spline",
+        "pchip"
+    ],
+    "summary": "Evaluate a piecewise-polynomial structure.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "GPU query points are gathered to the CPU reference implementation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "uniform"
+    },
+    "description": "`ppval(pp, xq)` evaluates a piecewise-polynomial structure produced by `spline` or `pchip` at query points `xq`.",
+    "behaviors": [
+        "Accepts pp structures with `form`, `breaks`, `coefs`, `pieces`, `order`, and `dim` fields.",
+        "Uses Horner evaluation within each interval.",
+        "Extrapolates outside the break range, matching MATLAB pp evaluation behavior."
+    ],
+    "examples": [
+        {
+            "description": "Evaluate a spline pp structure",
+            "input": "pp = spline([1 2 3], [1 4 9]);\nyq = ppval(pp, [1.5 2.5])",
+            "output": "yq = [2.25 6.25]"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "yq = ppval(pp, xq)"
+        },
+        "points": [
+            "`pp` is a piecewise-polynomial structure, typically returned by `spline` or `pchip`.",
+            "`xq` contains query points. Scalar queries return scalars, and array queries preserve their shape.",
+            "RunMat evaluates each interval with Horner's method using the pp coefficient table.",
+            "Queries outside the break range are extrapolated from the first or last polynomial piece."
+        ]
+    },
+    "links": [
+        {
+            "label": "spline",
+            "url": "./spline"
+        },
+        {
+            "label": "pchip",
+            "url": "./pchip"
+        }
+    ],
+    "source": {
+        "label": "Open an issue",
+        "url": "https://github.com/runmat-org/runmat/issues/new/choose"
+    },
+    "key": "ppval",
+    "slug": "ppval",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "interpolation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=ppval.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ppval.js","sourceRoot":"","sources":["../../../src/generated/builtins/ppval.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,OAAO;QACP,sBAAsB;QACtB,QAAQ;QACR,OAAO;KACR;IACD,SAAS,EAAE,4CAA4C;IACvD,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,oEAAoE;KAC9E;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,SAAS;KACvB;IACD,aAAa,EAAE,kHAAkH;IACjI,WAAW,EAAE;QACX,4FAA4F;QAC5F,8CAA8C;QAC9C,+EAA+E;KAChF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,2DAA2D;YACpE,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,oBAAoB;SAC9B;QACD,QAAQ,EAAE;YACR,sFAAsF;YACtF,oGAAoG;YACpG,qFAAqF;YACrF,2FAA2F;SAC5F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,wDAAwD;KAChE;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/spline.js

@@ -0,0 +1,84 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "spline",
+    "category": "math/interpolation",
+    "keywords": [
+        "spline",
+        "cubic spline",
+        "interpolation",
+        "pp",
+        "ppval"
+    ],
+    "summary": "Construct or evaluate a cubic spline interpolant.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "GPU inputs are gathered to the CPU reference implementation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "description": "`spline(x, y)` returns a piecewise-polynomial structure for cubic spline interpolation. `spline(x, y, xq)` evaluates that spline directly at query points.",
+    "behaviors": [
+        "Returns a pp structure with `form`, `breaks`, `coefs`, `pieces`, `order`, and `dim` fields.",
+        "The direct evaluation form extrapolates outside the sample range, matching MATLAB's standalone `spline` behavior.",
+        "Dense real numeric inputs are supported in the initial implementation."
+    ],
+    "examples": [
+        {
+            "description": "Build and evaluate a spline",
+            "input": "x = [1 2 3];\ny = [1 4 9];\npp = spline(x, y);\nyq = ppval(pp, [1.5 2.5])",
+            "output": "yq = [2.25 6.25]"
+        },
+        {
+            "description": "Direct evaluation",
+            "input": "x = [1 2 3];\ny = [1 4 9];\nyq = spline(x, y, 1.5)",
+            "output": "yq = 2.25"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "pp = spline(x, y)\nyq = spline(x, y, xq)"
+        },
+        "points": [
+            "`x` is a strictly increasing vector of sample locations.",
+            "`y` contains the sampled values to interpolate.",
+            "`spline(x, y)` returns a piecewise-polynomial structure compatible with `ppval`.",
+            "`spline(x, y, xq)` evaluates the cubic spline directly at query points.",
+            "Standalone `spline` extrapolates outside the sample range using the first or last polynomial piece."
+        ]
+    },
+    "links": [
+        {
+            "label": "interp1",
+            "url": "./interp1"
+        },
+        {
+            "label": "ppval",
+            "url": "./ppval"
+        }
+    ],
+    "source": {
+        "label": "Open an issue",
+        "url": "https://github.com/runmat-org/runmat/issues/new/choose"
+    },
+    "key": "spline",
+    "slug": "spline",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "interpolation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=spline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spline.js","sourceRoot":"","sources":["../../../src/generated/builtins/spline.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,QAAQ;QACR,cAAc;QACd,eAAe;QACf,IAAI;QACJ,OAAO;KACR;IACD,SAAS,EAAE,mDAAmD;IAC9D,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,8DAA8D;KACxE;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,aAAa,EAAE,4JAA4J;IAC3K,WAAW,EAAE;QACX,6FAA6F;QAC7F,mHAAmH;QACnH,wEAAwE;KACzE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,2EAA2E;YACpF,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,mBAAmB;YAClC,OAAO,EAAE,oDAAoD;YAC7D,QAAQ,EAAE,WAAW;SACtB;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,0CAA0C;SACpD;QACD,QAAQ,EAAE;YACR,0DAA0D;YAC1D,iDAAiD;YACjD,kFAAkF;YAClF,yEAAyE;YACzE,qGAAqG;SACtG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,wDAAwD;KAChE;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtins-manifest.d.ts","sourceRoot":"","sources":["../../src/generated/builtins-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,eAAO,MAAM,eAAe,EAAE,oBAAoB,EAkyOjD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAkX9D,CAAC;AAEF,eAAO,MAAM,4BAA4B,sEAC0C,CAAC"}
+{"version":3,"file":"builtins-manifest.d.ts","sourceRoot":"","sources":["../../src/generated/builtins-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,eAAO,MAAM,eAAe,EAAE,oBAAoB,EAy5OjD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAwX9D,CAAC;AAEF,eAAO,MAAM,4BAA4B,sEAC0C,CAAC"}