runmat 0.3.6 → 0.4.0

package/dist/generated/builtins/semilogx.js

@@ -0,0 +1,85 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "semilogx",
+    "category": "plotting",
+    "keywords": [
+        "semilogx",
+        "logarithmic x-axis",
+        "semilog plot",
+        "matlab semilogx",
+        "response curve"
+    ],
+    "summary": "Plot data with a logarithmic x-axis for response curves, scaling analysis, and MATLAB `semilogx` workflows.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "single",
+            "double"
+        ],
+        "broadcasting": "none",
+        "notes": "`semilogx` uses the shared `plot` rendering path and then marks the active axes as logarithmic on X."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::semilogx::tests"
+    },
+    "description": "`semilogx` creates the same line objects as `plot`, but configures the current axes to use a logarithmic x-axis. That makes it useful for response curves, magnitude plots, and data that spans orders of magnitude along X while still using familiar MATLAB `semilogx` call forms.",
+    "behaviors": [
+        "The builtin returns the same kind of numeric line handle as `plot`.",
+        "Only the x-axis is switched to log scale; the y-axis remains linear.",
+        "Axes log-mode state is subplot-local, so `semilogx` on one subplot does not force every axes in the figure into log mode.",
+        "Positive x-values are the meaningful domain for a logarithmic axis, even though the plotted line object still preserves the original data handle semantics."
+    ],
+    "examples": [
+        {
+            "description": "Plot a frequency response with a logarithmic x-axis",
+            "input": "f = logspace(0, 4, 200);\nmag = 1 ./ sqrt(1 + (f / 200).^2);\nsemilogx(f, mag);"
+        },
+        {
+            "description": "Compare two responses on the same semilog x-axis",
+            "input": "f = logspace(0, 4, 200);\nh1 = semilogx(f, 1 ./ sqrt(1 + (f / 200).^2));\nset(h1, 'DisplayName', 'low-pass');\nhold on;\nh2 = semilogx(f, (f / 200) ./ sqrt(1 + (f / 200).^2));\nset(h2, 'DisplayName', 'high-pass');\nlegend;"
+        },
+        {
+            "description": "Verify the x-axis scale through handle/property workflows",
+            "input": "f = logspace(1, 3, 50);\nsemilogx(f, log10(f));\nax = gca;\nget(ax, 'XScale')",
+            "output": "ans =\n    'log'"
+        }
+    ],
+    "links": [
+        {
+            "label": "plot",
+            "url": "./plot"
+        },
+        {
+            "label": "semilogy",
+            "url": "./semilogy"
+        },
+        {
+            "label": "loglog",
+            "url": "./loglog"
+        },
+        {
+            "label": "axis",
+            "url": "./axis"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/semilogx.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/semilogx.rs"
+    },
+    "key": "semilogx",
+    "slug": "semilogx",
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=semilogx.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semilogx.js","sourceRoot":"","sources":["../../../src/generated/builtins/semilogx.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,UAAU;QACV,oBAAoB;QACpB,cAAc;QACd,iBAAiB;QACjB,gBAAgB;KACjB;IACD,SAAS,EAAE,6GAA6G;IACxH,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,QAAQ;YACR,QAAQ;SACT;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,sGAAsG;KAChH;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,qCAAqC;KAC9C;IACD,aAAa,EAAE,sRAAsR;IACrS,WAAW,EAAE;QACX,qEAAqE;QACrE,sEAAsE;QACtE,2HAA2H;QAC3H,6JAA6J;KAC9J;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qDAAqD;YACpE,OAAO,EAAE,iFAAiF;SAC3F;QACD;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,gOAAgO;SAC1O;QACD;YACE,aAAa,EAAE,2DAA2D;YAC1E,OAAO,EAAE,+EAA+E;YACxF,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;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,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/semilogy.js

@@ -0,0 +1,69 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "semilogy",
+    "category": "plotting",
+    "keywords": [
+        "semilogy",
+        "logarithmic y-axis",
+        "semilog plot",
+        "matlab semilogy",
+        "exponential plot"
+    ],
+    "summary": "Plot data with a logarithmic y-axis for exponential trends, decay curves, and MATLAB `semilogy` workflows.",
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::semilogy::tests"
+    },
+    "description": "`semilogy` uses the standard RunMat line-plot path and then marks the active y-axis as logarithmic. It is a natural fit for exponential decay, growth curves, and magnitude data that spans orders of magnitude along Y while preserving MATLAB `semilogy` call forms.",
+    "behaviors": [
+        "The returned value is a numeric line handle.",
+        "Only the y-axis is switched to log scale; the x-axis remains linear.",
+        "Y log-mode state is subplot-local and does not leak into other subplot axes.",
+        "Positive y-values are the meaningful domain for a logarithmic y-axis."
+    ],
+    "examples": [
+        {
+            "description": "Plot an exponential decay on a logarithmic y-axis",
+            "input": "t = linspace(0, 10, 200);\nsemilogy(t, exp(-t));"
+        },
+        {
+            "description": "Compare multiple decays on the same axes",
+            "input": "t = linspace(0, 10, 200);\nh1 = semilogy(t, exp(-t));\nset(h1, 'DisplayName', 'exp(-t)');\nhold on;\nh2 = semilogy(t, exp(-0.3*t));\nset(h2, 'DisplayName', 'exp(-0.3t)');\nlegend;"
+        },
+        {
+            "description": "Inspect the y-axis scale after plotting",
+            "input": "t = 0:0.1:4;\nsemilogy(t, exp(t));\nax = gca;\nget(ax, 'YScale')",
+            "output": "ans =\n    'log'"
+        }
+    ],
+    "links": [
+        {
+            "label": "plot",
+            "url": "./plot"
+        },
+        {
+            "label": "semilogx",
+            "url": "./semilogx"
+        },
+        {
+            "label": "loglog",
+            "url": "./loglog"
+        },
+        {
+            "label": "axis",
+            "url": "./axis"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/semilogy.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/semilogy.rs"
+    },
+    "key": "semilogy",
+    "slug": "semilogy",
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=semilogy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semilogy.js","sourceRoot":"","sources":["../../../src/generated/builtins/semilogy.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,UAAU;QACV,oBAAoB;QACpB,cAAc;QACd,iBAAiB;QACjB,kBAAkB;KACnB;IACD,SAAS,EAAE,4GAA4G;IACvH,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,qCAAqC;KAC9C;IACD,aAAa,EAAE,wQAAwQ;IACvR,WAAW,EAAE;QACX,8CAA8C;QAC9C,sEAAsE;QACtE,8EAA8E;QAC9E,uEAAuE;KACxE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mDAAmD;YAClE,OAAO,EAAE,kDAAkD;SAC5D;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,qLAAqL;SAC/L;QACD;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;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,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/set.js

@@ -0,0 +1,69 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "set",
+    "category": "plotting",
+    "keywords": [
+        "set",
+        "graphics handle",
+        "plot properties",
+        "matlab set",
+        "update plotting state"
+    ],
+    "summary": "Update figure, axes, and plot-object properties through RunMat’s graphics handles and MATLAB-style `set` workflows.",
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::set::tests"
+    },
+    "description": "`set` applies property/value pairs to plotting handles. In RunMat, it is the public write path for the shared graphics object model: you can update text handles, legend handles, axes handles, and plot-child handles such as lines, stems, error bars, histograms, images, contour objects, and more through a MATLAB-style `set(h, 'Property', value)` interface.",
+    "behaviors": [
+        "`set` requires a plotting handle followed by one or more property/value pairs.",
+        "Different handle families accept different properties, and unsupported properties raise plotting errors rather than silently succeeding.",
+        "Axes-local state such as limits, log modes, and legend visibility can be updated through axes handles.",
+        "Plot-child properties such as line width, display names, marker styling, and selected object semantics are updated in place through the returned plot handles.",
+        "Legend and text objects participate in the same property path, so figure annotation workflows stay consistent with the rest of the handle model."
+    ],
+    "examples": [
+        {
+            "description": "Style a line after plotting",
+            "input": "h = plot(0:0.1:1, (0:0.1:1).^2);\nset(h, 'Color', 'r', 'LineWidth', 2, 'DisplayName', 'quadratic');"
+        },
+        {
+            "description": "Update axes-local state through an axes handle",
+            "input": "ax = subplot(1, 2, 2);\nplot(1:5, [2 3 5 4 1]);\nset(ax, 'XScale', 'log', 'Grid', false);"
+        },
+        {
+            "description": "Change a legend after it has been created",
+            "input": "plot(1:5, 1:5);\nlg = legend('series');\nset(lg, 'Location', 'southwest', 'Orientation', 'horizontal');"
+        }
+    ],
+    "links": [
+        {
+            "label": "get",
+            "url": "./get"
+        },
+        {
+            "label": "legend",
+            "url": "./legend"
+        },
+        {
+            "label": "subplot",
+            "url": "./subplot"
+        },
+        {
+            "label": "plot",
+            "url": "./plot"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/set.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/set.rs"
+    },
+    "key": "set",
+    "slug": "set",
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=set.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../src/generated/builtins/set.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,KAAK;QACL,iBAAiB;QACjB,iBAAiB;QACjB,YAAY;QACZ,uBAAuB;KACxB;IACD,SAAS,EAAE,qHAAqH;IAChI,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,gCAAgC;KACzC;IACD,aAAa,EAAE,sWAAsW;IACrX,WAAW,EAAE;QACX,gFAAgF;QAChF,0IAA0I;QAC1I,wGAAwG;QACxG,gKAAgK;QAChK,kJAAkJ;KACnJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,qGAAqG;SAC/G;QACD;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,2FAA2F;SACrG;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,yGAAyG;SACnH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,0DAA0D;QACnE,KAAK,EAAE,uGAAuG;KAC/G;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/setdiff.js

@@ -0,0 +1,171 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "setdiff",
+    "category": "array/sorting_sets",
+    "keywords": [
+        "setdiff",
+        "difference",
+        "stable",
+        "rows",
+        "indices",
+        "gpu"
+    ],
+    "summary": "Return values that appear in the first input but not the second, matching MATLAB ordering rules.",
+    "references": [
+        "https://www.mathworks.com/help/matlab/ref/setdiff.html"
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "When providers lack a dedicated `setdiff` hook, RunMat gathers GPU tensors to host memory and reuses the CPU path."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::array::sorting_sets::setdiff::tests",
+        "integration": "builtins::array::sorting_sets::setdiff::tests::setdiff_gpu_roundtrip"
+    },
+    "description": "`setdiff(A, B)` returns the set of values (or rows) that appear in `A` but not in `B`. Results are unique, and the function can operate in sorted or stable order as well as row mode.",
+    "behaviors": [
+        "`setdiff(A, B)` flattens inputs column-major, removes duplicates, subtracts the values of `B` from `A`, and returns the remaining elements **sorted** ascending by default.",
+        "`[C, IA] = setdiff(A, B)` also returns indices so that `C = A(IA)`.",
+        "`setdiff(A, B, 'stable')` preserves the first appearance order from `A` instead of sorting.",
+        "`setdiff(A, B, 'rows')` treats each row as an element. Inputs must share the same number of columns.",
+        "Character arrays, string arrays, logical arrays, numeric types, and complex values are all supported.",
+        "Legacy flags (`'legacy'`, `'R2012a'`) are not supported; RunMat always follows modern MATLAB semantics."
+    ],
+    "examples": [
+        {
+            "description": "Finding values exclusive to the first numeric vector",
+            "input": "A = [5 7 5 1];\nB = [7 1 3];\n[C, IA] = setdiff(A, B)",
+            "output": "C =\n     5\nIA =\n     1"
+        },
+        {
+            "description": "Preserving input order with `'stable'`",
+            "input": "A = [4 2 4 1 3];\nB = [3 4 5 1];\n[C, IA] = setdiff(A, B, 'stable')",
+            "output": "C =\n     2\nIA =\n     2"
+        },
+        {
+            "description": "Working with rows of numeric matrices",
+            "input": "A = [1 2; 3 4; 1 2];\nB = [3 4; 5 6];\n[C, IA] = setdiff(A, B, 'rows')",
+            "output": "C =\n     1     2\nIA =\n     1"
+        },
+        {
+            "description": "Computing set difference for character data",
+            "input": "A = ['m','z'; 'm','a'];\nB = ['a','x'; 'm','a'];\n[C, IA] = setdiff(A, B)",
+            "output": "C =\n    m\nIA =\n     1"
+        },
+        {
+            "description": "Subtracting string arrays by row",
+            "input": "A = [\"alpha\" \"beta\"; \"gamma\" \"beta\"];\nB = [\"gamma\" \"beta\"; \"delta\" \"beta\"];\n[C, IA] = setdiff(A, B, 'rows', 'stable')",
+            "output": "C =\n  1x2 string array\n    \"alpha\"    \"beta\"\nIA =\n     1"
+        },
+        {
+            "description": "Using `setdiff` with GPU arrays",
+            "input": "G = gpuArray([10 4 6 4]);\nH = gpuArray([6 4 2]);\nC = setdiff(G, H)",
+            "output": "C =\n    10"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What ordering does `setdiff` use by default?",
+            "answer": "Results are sorted ascending. Specify `'stable'` to preserve the first appearance order from the first input."
+        },
+        {
+            "question": "How are the index outputs defined?",
+            "answer": "`IA` points to the positions in `A` that correspond to each element (or row) returned in `C`, using MATLAB's one-based indexing."
+        },
+        {
+            "question": "Can I combine `'rows'` with `'stable'`?",
+            "answer": "Yes. `'rows'` can be paired with either `'sorted'` (default) or `'stable'`. Other option combinations that conflict (e.g. `'sorted'` with `'stable'`) are rejected."
+        },
+        {
+            "question": "Does `setdiff` remove `NaN` values from `A` when they exist in `B`?",
+            "answer": "Yes. `NaN` values are considered equal. If `B` contains `NaN`, all `NaN` entries from `A` are removed."
+        },
+        {
+            "question": "Are complex numbers supported?",
+            "answer": "Absolutely. Complex values use MATLAB's ordering rules (magnitude, then real part, then imaginary part) for the sorted output."
+        },
+        {
+            "question": "Does GPU execution change the results?",
+            "answer": "No. Until providers supply a device implementation, RunMat gathers GPU inputs and executes the CPU path to guarantee MATLAB-compatible behaviour."
+        },
+        {
+            "question": "What happens if the inputs have different classes?",
+            "answer": "RunMat follows MATLAB's rules: both inputs must share the same class (numeric/logical, complex, char, or string). Mixed-class inputs raise descriptive errors."
+        },
+        {
+            "question": "Can I request `'legacy'` behaviour?",
+            "answer": "No. RunMat implements the modern semantics only. Passing `'legacy'` or `'R2012a'` results in an error."
+        }
+    ],
+    "links": [
+        {
+            "label": "unique",
+            "url": "./unique"
+        },
+        {
+            "label": "union",
+            "url": "./union"
+        },
+        {
+            "label": "intersect",
+            "url": "./intersect"
+        },
+        {
+            "label": "ismember",
+            "url": "./ismember"
+        },
+        {
+            "label": "gpuArray",
+            "url": "./gpuarray"
+        },
+        {
+            "label": "gather",
+            "url": "./gather"
+        },
+        {
+            "label": "argsort",
+            "url": "./argsort"
+        },
+        {
+            "label": "issorted",
+            "url": "./issorted"
+        },
+        {
+            "label": "sort",
+            "url": "./sort"
+        },
+        {
+            "label": "sortrows",
+            "url": "./sortrows"
+        }
+    ],
+    "source": {
+        "label": "crates/runmat-runtime/src/builtins/array/sorting_sets/setdiff.rs",
+        "url": "crates/runmat-runtime/src/builtins/array/sorting_sets/setdiff.rs"
+    },
+    "gpu_behavior": [
+        "`setdiff` is registered as a residency sink. When tensors reside on the GPU and the active provider does not yet implement a `setdiff` hook, RunMat gathers them to host memory, performs the CPU implementation, and materialises host-resident results. Future providers can wire a custom hook to perform the set difference directly on-device without affecting existing callers."
+    ],
+    "key": "setdiff",
+    "slug": "setdiff",
+    "categoryPath": [
+        "array",
+        "sorting_sets"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=setdiff.js.map

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

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

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

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

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

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