runmat 0.5.7-dev.3 → 0.5.7-dev.4

package/dist/generated/builtins/clearCache.js

@@ -0,0 +1,81 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "clearCache",
+    "category": "introspection",
+    "keywords": [
+        "clearCache",
+        "memoize",
+        "MemoizedFunction",
+        "cache"
+    ],
+    "summary": "Clear the cache and counters for one MemoizedFunction object.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Host-side cache bookkeeping only."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::introspection::memoize",
+        "integration": "clearCache resets shared MemoizedFunction cache counters"
+    },
+    "description": "`clearCache(memoizedFcn)` removes all cached entries for a `MemoizedFunction` object and resets `TotalHits` and `TotalMisses` to zero.",
+    "behaviors": [
+        "The input must be a `MemoizedFunction` object returned by `memoize`.",
+        "Cache state is shared per wrapped function, so clearing one object also clears other memoized handles for the same function.",
+        "The operation returns zero internally and suppresses automatic output in statement form.",
+        "Object properties such as `Function`, `Enabled`, and `CacheSize` are preserved."
+    ],
+    "examples": [
+        {
+            "description": "Clear one memoized cache",
+            "input": "f = memoize(@sqrt);\nf(4);\nf(4);\nclearCache(f);\nS = stats(f)",
+            "output": "% S.Cache.TotalHits and TotalMisses are zero."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `clearCache` delete the MemoizedFunction object?",
+            "answer": "No. It only clears cache entries and counters."
+        },
+        {
+            "question": "Does it affect other functions?",
+            "answer": "No. Use `clearAllMemoizedCaches` to clear every memoized-function cache."
+        }
+    ],
+    "links": [
+        {
+            "label": "memoize",
+            "url": "./memoize"
+        },
+        {
+            "label": "clearAllMemoizedCaches",
+            "url": "./clearAllMemoizedCaches"
+        },
+        {
+            "label": "stats",
+            "url": "./stats"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/introspection/memoize.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/introspection/memoize.rs"
+    },
+    "key": "clearcache",
+    "slug": "clearcache",
+    "aliases": [],
+    "categoryPath": [
+        "introspection"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=clearCache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clearCache.js","sourceRoot":"","sources":["../../../src/generated/builtins/clearCache.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,YAAY;QACZ,SAAS;QACT,kBAAkB;QAClB,OAAO;KACR;IACD,SAAS,EAAE,+DAA+D;IAC1E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mCAAmC;KAC7C;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,kCAAkC;QAC1C,aAAa,EAAE,0DAA0D;KAC1E;IACD,aAAa,EAAE,wIAAwI;IACvJ,WAAW,EAAE;QACX,sEAAsE;QACtE,8HAA8H;QAC9H,0FAA0F;QAC1F,iFAAiF;KAClF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,iEAAiE;YAC1E,QAAQ,EAAE,+CAA+C;SAC1D;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uDAAuD;YACnE,QAAQ,EAAE,gDAAgD;SAC3D;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,0EAA0E;SACrF;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,0BAA0B;SAClC;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/clearvars.js

@@ -36,6 +36,7 @@ const builtinDoc = {
         "Multiple names can be supplied as separate inputs or command-form tokens, for example `clearvars x y z`.",
         "`clearvars -except x y` removes all active workspace variables except `x` and `y`.",
         "`clearvars a b c -except b` removes only selected variables `a` and `c`, preserves selected exclusion `b`, and leaves variables outside the selected clear set untouched.",
+        "Active `onCleanup` objects are invoked before removed workspace bindings are deleted; excluded cleanup objects remain active.",
         "Function-call forms accept variable names as string scalars, row character vectors, or string arrays.",
         "Clearing a name that does not exist is a no-op.",
         "`clearvars` is a sink builtin and does not produce a meaningful output value."

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

@@ -1 +1 @@
-{"version":3,"file":"clearvars.js","sourceRoot":"","sources":["../../../src/generated/builtins/clearvars.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,WAAW;QACX,iBAAiB;QACjB,WAAW;QACX,WAAW;QACX,SAAS;KACV;IACD,SAAS,EAAE,0EAA0E;IACrF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,2FAA2F;KACrG;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,IAAI;QACZ,aAAa,EAAE,4DAA4D;KAC5E;IACD,aAAa,EAAE,mLAAmL;IAClM,WAAW,EAAE;QACX,2FAA2F;QAC3F,uFAAuF;QACvF,0GAA0G;QAC1G,oFAAoF;QACpF,2KAA2K;QAC3K,uGAAuG;QACvG,iDAAiD;QACjD,+EAA+E;KAChF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,kCAAkC;YAC3C,QAAQ,EAAE,0CAA0C;SACrD;QACD;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,0CAA0C;SACrD;QACD;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,4DAA4D;YACrE,QAAQ,EAAE,mDAAmD;SAC9D;QACD;YACE,aAAa,EAAE,sDAAsD;YACrE,OAAO,EAAE,mEAAmE;YAC5E,QAAQ,EAAE,uDAAuD;SAClE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,qIAAqI;SAChJ;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,+IAA+I;SAC1J;QACD;YACE,UAAU,EAAE,0DAA0D;YACtE,QAAQ,EAAE,yGAAyG;SACpH;QACD;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,yGAAyG;SACpH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iEAAiE;QAC1E,KAAK,EAAE,8GAA8G;KACtH;IACD,cAAc,EAAE;QACd,wKAAwK;KACzK;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"clearvars.js","sourceRoot":"","sources":["../../../src/generated/builtins/clearvars.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,WAAW;QACX,iBAAiB;QACjB,WAAW;QACX,WAAW;QACX,SAAS;KACV;IACD,SAAS,EAAE,0EAA0E;IACrF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,2FAA2F;KACrG;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,IAAI;QACZ,aAAa,EAAE,4DAA4D;KAC5E;IACD,aAAa,EAAE,mLAAmL;IAClM,WAAW,EAAE;QACX,2FAA2F;QAC3F,uFAAuF;QACvF,0GAA0G;QAC1G,oFAAoF;QACpF,2KAA2K;QAC3K,+HAA+H;QAC/H,uGAAuG;QACvG,iDAAiD;QACjD,+EAA+E;KAChF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,kCAAkC;YAC3C,QAAQ,EAAE,0CAA0C;SACrD;QACD;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,0CAA0C;SACrD;QACD;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,4DAA4D;YACrE,QAAQ,EAAE,mDAAmD;SAC9D;QACD;YACE,aAAa,EAAE,sDAAsD;YACrE,OAAO,EAAE,mEAAmE;YAC5E,QAAQ,EAAE,uDAAuD;SAClE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,qIAAqI;SAChJ;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,+IAA+I;SAC1J;QACD;YACE,UAAU,EAAE,0DAA0D;YACtE,QAAQ,EAAE,yGAAyG;SACpH;QACD;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,yGAAyG;SACpH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iEAAiE;QAC1E,KAAK,EAAE,8GAA8G;KACtH;IACD,cAAc,EAAE;QACd,wKAAwK;KACzK;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/close.js

@@ -2,13 +2,14 @@
 // Do not edit by hand.
 const builtinDoc = {
     "title": "close",
-    "category": "io/net",
+    "category": "general",
     "keywords": [
         "close",
         "tcpclient",
         "tcpserver",
         "socket",
-        "networking"
+        "networking",
+        "figure"
     ],
     "summary": "Close figures or networking resources in MATLAB and RunMat.",
     "gpu_support": {
@@ -26,20 +27,33 @@ const builtinDoc = {
     },
     "requires_feature": null,
     "tested": {
-        "unit": "builtins::io::net::close::tests",
-        "integration": "builtins::io::net::close::tests::close_tcpclient_releases_handle"
+        "unit": "builtins::plotting::close::tests and builtins::io::net::close::tests",
+        "integration": "runmat-core close command rewrite and no-current-figure execution tests"
     },
-    "description": "`close` releases resources such as plotting figures and TCP clients/servers. Object and selector forms return status codes indicating whether handles were closed, following MATLAB and RunMat close semantics.",
+    "description": "`close` releases plotting figures and TCP clients/servers. Bare `close` targets the current figure and is a no-op when no figures exist, so common startup code such as `clc; clear; close` is safe. Object and selector forms return status codes indicating whether handles were closed.",
     "behaviors": [
+        "`close` with no arguments closes the current figure when one exists. If no figure exists, it returns `0` and does not create or error on a default figure.",
+        "`close('all')` closes every open figure. Networking resources use explicit selectors such as `close('clients')` and `close('servers')`.",
+        "`close(fig)` closes an explicit figure handle and raises a figure-handle diagnostic if that explicit handle does not exist.",
         "`close(t)` closes the TCP client struct `t` that was previously returned by `tcpclient` or `accept`. Subsequent socket operations on that client raise MATLAB-style “not connected” diagnostics.",
         "`close(s)` closes the TCP server struct `s` that was returned by `tcpserver`. Any clients that were accepted from that server are also disconnected to match MATLAB’s lifecycle rules.",
-        "`close('clients')` closes every registered TCP client (including those produced by `accept`). Likewise, `close('servers')` closes every TCP server, and `close('all')` closes both clients and servers.",
+        "`close('clients')` closes every registered TCP client (including those produced by `accept`). Likewise, `close('servers')` closes every TCP server. Use those explicit networking selectors instead of `close('all')`, which is reserved for figure closure.",
         "Multiple inputs are processed from left to right. The return value is `1` when at least one handle was closed and `0` otherwise.",
         "Invalid arguments raise `RunMat:close:InvalidArgument`. Structs that do not contain the hidden RunMat networking identifiers raise `RunMat:close:InvalidHandle`.",
         "Networking happens on the CPU. If the arguments live on the GPU, RunMat gathers them automatically before touching the host-side registries.",
         "Arguments wrapped in cell arrays (possibly nested) or scalar string arrays are supported. `close` walks each element in-order and applies the usual rules to every value it discovers."
     ],
     "examples": [
+        {
+            "description": "Start a script safely when no figures are open",
+            "input": "clc;\nclear;\nstatus = close",
+            "output": "status = 0"
+        },
+        {
+            "description": "Close the current figure",
+            "input": "figure(7);\nstatus = close",
+            "output": "status = 7"
+        },
         {
             "description": "Close a TCP client after finishing I/O",
             "input": "client = tcpclient(\"127.0.0.1\", 50000);\nstatus = close(client)",
@@ -56,9 +70,9 @@ const builtinDoc = {
             "output": "status = 1"
         },
         {
-            "description": "Close all networking resources at once",
-            "input": "client = tcpclient(\"localhost\", 40000);\nsrv = tcpserver(\"localhost\", 0);\nstatus = close(\"all\")",
-            "output": "status = 1"
+            "description": "Close networking resources by selector",
+            "input": "client = tcpclient(\"localhost\", 40000);\nsrv = tcpserver(\"localhost\", 0);\nclientStatus = close(\"clients\");\nserverStatus = close(\"servers\")",
+            "output": "clientStatus = 1\nserverStatus = 1"
         },
         {
             "description": "Calling close on an already-closed client",
@@ -72,9 +86,13 @@ const builtinDoc = {
         }
     ],
     "faqs": [
+        {
+            "question": "Is bare `close` safe when no figures are open?",
+            "answer": "Yes. RunMat treats bare `close` as a no-op when there is no current figure, returning `0` instead of creating a default figure or raising an invalid-handle error."
+        },
         {
             "question": "What does the return value represent?",
-            "answer": "The return value is `1` when at least one client or server was closed and `0` otherwise. Use it to detect whether `close` released any networking resources."
+            "answer": "For figure targets, the return value is the closed figure handle for a single target or a count for multi-target/all closures. For networking resources, it is `1` when at least one client or server was closed and `0` otherwise."
         },
         {
             "question": "Can I pass multiple clients or servers at once?",
@@ -98,6 +116,10 @@ const builtinDoc = {
         }
     ],
     "links": [
+        {
+            "label": "figure",
+            "url": "./figure"
+        },
         {
             "label": "tcpclient",
             "url": "./tcpclient"
@@ -124,8 +146,8 @@ const builtinDoc = {
         }
     ],
     "source": {
-        "label": "crates/runmat-runtime/src/builtins/io/net/close.rs",
-        "url": "crates/runmat-runtime/src/builtins/io/net/close.rs"
+        "label": "crates/runmat-runtime/src/builtins/close/mod.rs",
+        "url": "crates/runmat-runtime/src/builtins/close/mod.rs"
     },
     "gpu_behavior": [
         "`close` performs only CPU-side bookkeeping. When network structs or option strings reside on the GPU, RunMat gathers them to host memory before inspecting their hidden identifiers. No provider hooks participate, and GPU residency is irrelevant to the close operation."
@@ -134,8 +156,7 @@ const builtinDoc = {
     "slug": "close",
     "aliases": [],
     "categoryPath": [
-        "io",
-        "net"
+        "general"
     ]
 };
 export default builtinDoc;

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

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

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

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

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

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

package/dist/generated/builtins/colorcube.js

@@ -0,0 +1,61 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "colorcube",
+    "category": "plotting",
+    "keywords": [
+        "colorcube",
+        "colormap",
+        "rgb colormap",
+        "matlab colormap"
+    ],
+    "summary": "Return the colorcube colormap as an m-by-3 RGB array.",
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::colormap_arrays"
+    },
+    "description": "`colorcube` returns a colorcube palette as an m-by-3 numeric RGB array with values in [0, 1]. With no argument, it uses the current colormap length, or 256 when no figure colormap length is active.",
+    "behaviors": [
+        "`colorcube()` returns an m-by-3 RGB matrix.",
+        "`colorcube(m)` returns exactly `m` rows, where `m` must be a nonnegative integer.",
+        "The result can be passed directly to `colormap`."
+    ],
+    "examples": [
+        {
+            "description": "Apply a colorcube colormap",
+            "input": "surf(peaks(40));\ncolormap(colorcube(64));\ncolorbar;"
+        },
+        {
+            "description": "Generate a colorcube matrix",
+            "input": "c = colorcube(32);"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What size is `colorcube()`?",
+            "answer": "It returns the active colormap length when one exists, otherwise 256 rows by 3 columns."
+        }
+    ],
+    "links": [
+        {
+            "label": "colormap",
+            "url": "./colormap"
+        },
+        {
+            "label": "colorbar",
+            "url": "./colorbar"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/colormap_arrays.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/colormap_arrays.rs"
+    },
+    "key": "colorcube",
+    "slug": "colorcube",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=colorcube.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"colorcube.js","sourceRoot":"","sources":["../../../src/generated/builtins/colorcube.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,WAAW;QACX,UAAU;QACV,cAAc;QACd,iBAAiB;KAClB;IACD,SAAS,EAAE,uDAAuD;IAClE,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,qCAAqC;KAC9C;IACD,aAAa,EAAE,uMAAuM;IACtN,WAAW,EAAE;QACX,6CAA6C;QAC7C,mFAAmF;QACnF,kDAAkD;KACnD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,uDAAuD;SACjE;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,oBAAoB;SAC9B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6BAA6B;YACzC,QAAQ,EAAE,yFAAyF;SACpG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sEAAsE;QAC/E,KAAK,EAAE,mHAAmH;KAC3H;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/colormap.js

@@ -15,9 +15,11 @@ const builtinDoc = {
     "tested": {
         "unit": "builtins::plotting::cmds"
     },
-    "description": "`colormap` sets the active color palette for the current plotting context. It affects colormap-driven visualizations such as `imagesc`, `surf`, and `contourf`, scoped to the active axes in MATLAB and RunMat.",
+    "description": "`colormap` sets the active color palette for the current plotting context. It accepts a named palette or an m-by-3 RGB matrix with values in [0, 1], and affects colormap-driven visualizations such as `imagesc`, `surf`, and `contourf`, scoped to the active axes in MATLAB and RunMat.",
     "behaviors": [
-        "Supported colormap names include `parula`, `viridis`, `plasma`, `inferno`, `magma`, `turbo`, `jet`, `hot`, `cool`, `spring`, `summer`, `autumn`, `winter`, `gray`, `bone`, `copper`, `pink`, and `lines`.",
+        "Supported colormap names include `parula`, `colorcube`, `viridis`, `plasma`, `inferno`, `magma`, `turbo`, `jet`, `hot`, `cool`, `spring`, `summer`, `autumn`, `winter`, `gray`, `bone`, `copper`, `pink`, and `lines`.",
+        "Named colormaps are also available as RGB array generator functions, so MATLAB forms such as `colormap(jet)`, `colormap(gray(64))`, and `c = turbo(128)` are supported.",
+        "RGB matrix inputs are validated as m-by-3 numeric arrays with finite values in [0, 1] and are preserved in plotting state and scene serialization.",
         "Unknown colormap names raise errors rather than silently falling back.",
         "Colormap state composes naturally with `colorbar`, `imagesc`, `surf`, and filled contour plots.",
         "Colormap changes apply to the current axes context in the plotting state model."
@@ -30,12 +32,20 @@ const builtinDoc = {
         {
             "description": "Compare palettes across subplots",
             "input": "[X, Y] = meshgrid(linspace(-3, 3, 40), linspace(-3, 3, 40));\nZ = sin(X) .* cos(Y);\nsubplot(1, 2, 1);\nsurf(X, Y, Z);\ncolormap('parula');\nsubplot(1, 2, 2);\ncontourf(X, Y, Z);\ncolormap('turbo');"
+        },
+        {
+            "description": "Apply a generated RGB colormap matrix",
+            "input": "surf(peaks(40));\ncolormap(parula(128));\ncolorbar;"
+        },
+        {
+            "description": "Apply a MATLAB-style named colormap generator",
+            "input": "mandelbrot();\ncolormap(jet);"
         }
     ],
     "faqs": [
         {
             "question": "What colormaps are available?",
-            "answer": "RunMat ships with: `parula`, `viridis`, `plasma`, `inferno`, `magma`, `turbo`, `jet`, `hot`, `cool`, `spring`, `summer`, `autumn`, `winter`, `gray`, `bone`, `copper`, `pink`, and `lines`. Unknown names raise an error — no silent fallback."
+            "answer": "RunMat ships with: `parula`, `colorcube`, `viridis`, `plasma`, `inferno`, `magma`, `turbo`, `jet`, `hot`, `cool`, `spring`, `summer`, `autumn`, `winter`, `gray`, `bone`, `copper`, `pink`, and `lines`. Unknown names raise an error — no silent fallback."
         },
         {
             "question": "Which colormaps are perceptually uniform?",
@@ -43,7 +53,7 @@ const builtinDoc = {
         },
         {
             "question": "Can I define a custom colormap?",
-            "answer": "Not yet — `colormap` currently accepts named strings only. Custom N×3 RGB matrices are on the roadmap. For now, pick the closest built-in option or combine subplot-level colormaps to get variety across panels."
+            "answer": "Yes. Pass an m-by-3 RGB matrix with finite values in [0, 1], for example `colormap([0 0 0; 1 0.5 0; 1 1 1])`. RunMat preserves matrix inputs in plotting state and scene serialization."
         }
     ],
     "links": [

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

@@ -1 +1 @@
-{"version":3,"file":"colormap.js","sourceRoot":"","sources":["../../../src/generated/builtins/colormap.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,eAAe;QACf,iBAAiB;QACjB,iBAAiB;QACjB,iBAAiB;KAClB;IACD,SAAS,EAAE,wDAAwD;IACnE,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,0BAA0B;KACnC;IACD,aAAa,EAAE,iNAAiN;IAChO,WAAW,EAAE;QACX,2MAA2M;QAC3M,wEAAwE;QACxE,iGAAiG;QACjG,iFAAiF;KAClF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,+HAA+H;SACzI;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,wMAAwM;SAClN;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+BAA+B;YAC3C,QAAQ,EAAE,gPAAgP;SAC3P;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,2VAA2V;SACtW;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,mNAAmN;SAC9N;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,8BAA8B;YACvC,KAAK,EAAE,6CAA6C;SACrD;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,uCAAuC;SAC/C;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,uCAAuC;SAC/C;QACD;YACE,OAAO,EAAE,yBAAyB;YAClC,KAAK,EAAE,6BAA6B;SACrC;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"colormap.js","sourceRoot":"","sources":["../../../src/generated/builtins/colormap.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,eAAe;QACf,iBAAiB;QACjB,iBAAiB;QACjB,iBAAiB;KAClB;IACD,SAAS,EAAE,wDAAwD;IACnE,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,0BAA0B;KACnC;IACD,aAAa,EAAE,4RAA4R;IAC3S,WAAW,EAAE;QACX,wNAAwN;QACxN,yKAAyK;QACzK,oJAAoJ;QACpJ,wEAAwE;QACxE,iGAAiG;QACjG,iFAAiF;KAClF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,+HAA+H;SACzI;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,wMAAwM;SAClN;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,qDAAqD;SAC/D;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,+BAA+B;SACzC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+BAA+B;YAC3C,QAAQ,EAAE,6PAA6P;SACxQ;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,2VAA2V;SACtW;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,yLAAyL;SACpM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,8BAA8B;YACvC,KAAK,EAAE,6CAA6C;SACrD;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,uCAAuC;SAC/C;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,uCAAuC;SAC/C;QACD;YACE,OAAO,EAAE,yBAAyB;YAClC,KAAK,EAAE,6BAA6B;SACrC;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/colororder.js

@@ -0,0 +1,93 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "colororder",
+    "category": "plotting",
+    "keywords": [
+        "colororder",
+        "color order",
+        "plot colors",
+        "axes palette",
+        "matlab colororder"
+    ],
+    "summary": "Set or query the plotting color order in MATLAB and RunMat.",
+    "requires_feature": null,
+    "gpu": {
+        "residency": "host",
+        "fusion": "none",
+        "notes": "`colororder` updates figure and axes styling metadata. It does not inspect, gather, or transform plotted data buffers."
+    },
+    "tested": {
+        "unit": "builtins::plotting::colororder::tests"
+    },
+    "description": "`colororder` controls the implicit series colors used by line-style plotting commands. RunMat supports querying the current color order, setting figure-wide or axes-specific palettes, RGB triplet matrices, string and cell string color specifications, hex colors, and common MATLAB palette names.",
+    "behaviors": [
+        "`colororder()` returns the current figure color order as an m-by-3 RGB triplet matrix.",
+        "`colororder(colors)` sets the color order for the current figure and applies it to existing axes.",
+        "`colororder(ax, colors)` sets the color order for the specified axes without changing the current axes.",
+        "`colororder(fig, colors)` sets the color order for every axes in the specified figure.",
+        "Numeric color arrays must be m-by-3 RGB triplet matrices with finite values in [0, 1]. A single RGB triplet vector is accepted as one color.",
+        "String and cell string color arrays accept MATLAB color names, short color tokens, and `#RGB` or `#RRGGBB` hex strings.",
+        "Palette names include `default`, `gem`, `gem12`, `glow`, `glow12`, `sail`, `reef`, `meadow`, `dye`, and `earth`.",
+        "Changing the color order recolors existing line/scatter/bar-family series cyclically and controls future implicit plot colors."
+    ],
+    "examples": [
+        {
+            "description": "Set a custom RGB color order",
+            "input": "x = 0:0.1:1;\nplot(x, x, x, x.^2, x, x.^3);\ncolororder([1 0 0; 0 0.5 0; 0 0 1]);",
+            "output": "% Existing and future implicit series use red, green, and blue cyclically."
+        },
+        {
+            "description": "Use color names and hex strings",
+            "input": "colororder({'red', '#00AAFF', 'black'});\nplot(1:5, rand(5,3));"
+        },
+        {
+            "description": "Set an axes-specific color order",
+            "input": "ax1 = subplot(1,2,1);\nplot(rand(5,3));\nax2 = subplot(1,2,2);\nplot(rand(5,3));\ncolororder(ax2, 'gem');"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How is colororder different from colormap?",
+            "answer": "`colororder` controls the discrete sequence of implicit colors for plot series such as lines and scatter groups. `colormap` controls continuous color mapping for image, surface, heatmap, and contour data."
+        },
+        {
+            "question": "Does colororder gather gpuArray plot data?",
+            "answer": "No. The builtin only updates axes and figure style metadata plus existing plot object colors. It does not read or materialize plotted numeric data."
+        },
+        {
+            "question": "Does setting colororder change the current axes?",
+            "answer": "No. Targeted forms such as `colororder(ax, colors)` update that axes without selecting it as the current axes."
+        }
+    ],
+    "links": [
+        {
+            "label": "plot",
+            "url": "./plot"
+        },
+        {
+            "label": "colormap",
+            "url": "./colormap"
+        },
+        {
+            "label": "set",
+            "url": "./set"
+        },
+        {
+            "label": "Styling plots and axes",
+            "url": "/docs/plotting/styling-plots-and-axes"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/colororder.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/colororder.rs"
+    },
+    "key": "colororder",
+    "slug": "colororder",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=colororder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"colororder.js","sourceRoot":"","sources":["../../../src/generated/builtins/colororder.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,YAAY;QACZ,aAAa;QACb,aAAa;QACb,cAAc;QACd,mBAAmB;KACpB;IACD,SAAS,EAAE,6DAA6D;IACxE,kBAAkB,EAAE,IAAI;IACxB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM;QACnB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,wHAAwH;KAClI;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,uCAAuC;KAChD;IACD,aAAa,EAAE,ySAAyS;IACxT,WAAW,EAAE;QACX,wFAAwF;QACxF,mGAAmG;QACnG,yGAAyG;QACzG,wFAAwF;QACxF,8IAA8I;QAC9I,yHAAyH;QACzH,kHAAkH;QAClH,gIAAgI;KACjI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,mFAAmF;YAC5F,QAAQ,EAAE,4EAA4E;SACvF;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,iEAAiE;SAC3E;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,2GAA2G;SACrH;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,8MAA8M;SACzN;QACD;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,qJAAqJ;SAChK;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,gHAAgH;SAC3H;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,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,uCAAuC;SAC/C;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iEAAiE;QAC1E,KAAK,EAAE,8GAA8G;KACtH;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/combinations.js

@@ -0,0 +1,48 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "combinations",
+    "category": "array/grouping",
+    "keywords": [
+        "combinations",
+        "cartesian",
+        "table",
+        "combinatorics"
+    ],
+    "summary": "Generate all element combinations of arrays.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Combination materialization runs on the host."
+    },
+    "tested": {
+        "unit": "builtins::array::grouping::tests"
+    },
+    "description": "`T = combinations(A,B,...)` returns a table whose rows contain the Cartesian product of the input vector elements.",
+    "behaviors": [
+        "Supports numeric, logical, string, character, and cell inputs.",
+        "Supports the `VariableNames` name-value option."
+    ],
+    "examples": [
+        {
+            "description": "Generate pairs",
+            "input": "T = combinations([1 2],[\"x\" \"y\"])",
+            "output": "T = 4x2 table"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/array/grouping.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/array/grouping.rs"
+    },
+    "key": "combinations",
+    "slug": "combinations",
+    "aliases": [],
+    "categoryPath": [
+        "array",
+        "grouping"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=combinations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"combinations.js","sourceRoot":"","sources":["../../../src/generated/builtins/combinations.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE;QACV,cAAc;QACd,WAAW;QACX,OAAO;QACP,eAAe;KAChB;IACD,SAAS,EAAE,8CAA8C;IACzD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,+CAA+C;KACzD;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,kCAAkC;KAC3C;IACD,aAAa,EAAE,oHAAoH;IACnI,WAAW,EAAE;QACX,gEAAgE;QAChE,iDAAiD;KAClD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,eAAe;SAC1B;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/combvec.js

@@ -0,0 +1,47 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "combvec",
+    "category": "deep_learning",
+    "keywords": [
+        "combvec",
+        "deep learning",
+        "neural network",
+        "cartesian product"
+    ],
+    "summary": "Generate all column combinations from numeric matrices.",
+    "description": "`combvec(A,B,...)` returns a numeric matrix whose columns are all combinations of the input matrix columns, with the first input varying fastest.",
+    "behaviors": [
+        "Inputs must be finite numeric scalars or 2-D matrices.",
+        "The output row count is the sum of the input row counts, and the output column count is the product of the input column counts.",
+        "Very large outputs are rejected before allocation."
+    ],
+    "examples": [
+        {
+            "description": "Combine Vectors",
+            "input": "M = combvec([1 2], [10 20 30])",
+            "output": "`M` is 2-by-6."
+        },
+        {
+            "description": "Combine Matrix Columns",
+            "input": "M = combvec([1 3; 2 4], [10 20])",
+            "output": "`M` is 3-by-4, stacking one column from each input per output column."
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "M = combvec(A, B, ...)",
+            "output": "Numeric combination matrix."
+        }
+    },
+    "gpu_residency": "`combvec` materializes a host numeric matrix in this slice; provider-resident Cartesian generation remains future GPU work.",
+    "key": "combvec",
+    "slug": "combvec",
+    "aliases": [],
+    "categoryPath": [
+        "deep_learning"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=combvec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"combvec.js","sourceRoot":"","sources":["../../../src/generated/builtins/combvec.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,eAAe;QACf,gBAAgB;QAChB,mBAAmB;KACpB;IACD,SAAS,EAAE,yDAAyD;IACpE,aAAa,EAAE,mJAAmJ;IAClK,WAAW,EAAE;QACX,wDAAwD;QACxD,iIAAiI;QACjI,oDAAoD;KACrD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,gCAAgC;YACzC,QAAQ,EAAE,gBAAgB;SAC3B;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,kCAAkC;YAC3C,QAAQ,EAAE,uEAAuE;SAClF;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,wBAAwB;YACjC,QAAQ,EAAE,6BAA6B;SACxC;KACF;IACD,eAAe,EAAE,6HAA6H;IAC9I,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}