runmat 0.5.2-dev.6 → 0.5.3-dev.0

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

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

package/dist/generated/builtins/addpath.js

@@ -34,6 +34,7 @@ const builtinDoc = {
     "description": "`addpath` prepends or appends folders to the active search path used to resolve functions, scripts, classes, and data files. Changes apply immediately to the current session, with path ordering behavior matching MATLAB semantics.",
     "behaviors": [
         "Folder arguments may be character vectors, string scalars, string arrays, or cell arrays of character vectors or strings. Multi-row char arrays contribute one folder per row (trailing padding is stripped).",
+        "MATLAB command form is supported for path-like arguments, including `addpath ./SourceCode`, `addpath ../lib -end`, and `addpath ./src:../shared -frozen`.",
         "Multiple folders can be passed in a single argument using the platform path separator (`:` on Linux/macOS, `;` on Windows); this is compatible with `genpath`.",
         "By default, folders are added to the top of the search path. Use `'-end'` to append or `'-begin'` to force prepending explicitly. Only one position flag is permitted.",
         "The `'-frozen'` flag is accepted for MATLAB compatibility. RunMat does not currently track frozen entries separately; the flag simply suppresses incompatibility warnings.",
@@ -47,6 +48,11 @@ const builtinDoc = {
             "input": "mkdir(\"util/toolbox\");\noldPath = path();\naddpath(\"util/toolbox\");\nnewPath = path();\ncount = fprintf('%s %s\\n', oldPath, newPath);",
             "output": " /util/toolbox"
         },
+        {
+            "description": "Add a relative folder with MATLAB command syntax",
+            "input": "mkdir(\"SourceCode\");\noldPath = path();\naddpath ./SourceCode\nnewPath = path();\ncount = fprintf('%s %s\\n', oldPath, newPath);",
+            "output": " /SourceCode"
+        },
         {
             "description": "Append folders to the end of the search path",
             "input": "mkdir(\"shared/filters\");\nmkdir(\"shared/signal\");\noldPath = path();\ndirs = [\"shared/filters\", \"shared/signal\"];\naddpath(dirs, \"-end\");\nnewPath = path();\ncount = fprintf('%s %s\\n', oldPath, newPath);",

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

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

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

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

package/dist/generated/builtins/axis.js

@@ -7,6 +7,7 @@ const builtinDoc = {
         "axis",
         "axis limits",
         "axis equal",
+        "axis image",
         "axis tight",
         "matlab axis"
     ],
@@ -15,10 +16,11 @@ const builtinDoc = {
     "tested": {
         "unit": "builtins::plotting::cmds"
     },
-    "description": "`axis` configures limits and aspect behavior for the active axes. It supports numeric limit vectors and command forms such as `axis equal`, `axis auto`, and `axis tight`, matching MATLAB and RunMat plotting semantics.",
+    "description": "`axis` configures limits and aspect behavior for the active axes. It supports numeric limit vectors and command forms such as `axis equal`, `axis image`, `axis auto`, and `axis tight`, matching MATLAB and RunMat plotting semantics.",
     "behaviors": [
         "Passing a four-element numeric vector sets `[xmin xmax ymin ymax]` directly.",
         "`axis equal` enables equal aspect behavior on the current axes.",
+        "`axis image` enables equal aspect behavior and returns limits to data-fitted bounds, matching MATLAB's `axis equal` plus `axis tight` behavior.",
         "`axis auto` clears explicit limits and returns to automatic fitting.",
         "`axis tight` uses data-driven fitting behavior while leaving figure-local plot contents unchanged.",
         "Axis settings are subplot-local because they act on the active axes state."
@@ -32,6 +34,10 @@ const builtinDoc = {
             "description": "Force equal axis scaling",
             "input": "t = linspace(0, 2*pi, 200);\nplot(cos(t), sin(t));\naxis equal;"
         },
+        {
+            "description": "Display image data with square pixels",
+            "input": "imagesc([1 2; 3 4]);\naxis image;"
+        },
         {
             "description": "Return to automatic fitting inside a subplot",
             "input": "subplot(1, 2, 1);\nplot(1:5, [1 4 2 5 3]);\naxis tight;\nsubplot(1, 2, 2);\nplot(1:5, [5 4 3 2 1]);\naxis auto;"
@@ -49,6 +55,10 @@ const builtinDoc = {
         {
             "question": "What does axis tight actually do?",
             "answer": "`axis tight` fits the axes limits snugly around the plotted data with no padding. Compare to `axis auto`, which may add margin for readability. Use `tight` when you want the data to fill the entire axes area — useful for image-like plots or when whitespace is wasted space."
+        },
+        {
+            "question": "What does axis image do?",
+            "answer": "`axis image` combines equal aspect behavior with data-fitted limits. It is intended for image displays where pixels should appear square and the axes should fit the image data."
         }
     ],
     "links": [

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

@@ -1 +1 @@
-{"version":3,"file":"axis.js","sourceRoot":"","sources":["../../../src/generated/builtins/axis.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,aAAa;QACb,YAAY;QACZ,YAAY;QACZ,aAAa;KACd;IACD,SAAS,EAAE,oEAAoE;IAC/E,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,0BAA0B;KACnC;IACD,aAAa,EAAE,2NAA2N;IAC1O,WAAW,EAAE;QACX,8EAA8E;QAC9E,iEAAiE;QACjE,sEAAsE;QACtE,oGAAoG;QACpG,4EAA4E;KAC7E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,oDAAoD;SAC9D;QACD;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,iEAAiE;SAC3E;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,iHAAiH;SAC3H;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+DAA+D;YAC3E,QAAQ,EAAE,wTAAwT;SACnU;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,8NAA8N;SACzO;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,mRAAmR;SAC9R;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;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,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"axis.js","sourceRoot":"","sources":["../../../src/generated/builtins/axis.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,aAAa;QACb,YAAY;QACZ,YAAY;QACZ,YAAY;QACZ,aAAa;KACd;IACD,SAAS,EAAE,oEAAoE;IAC/E,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,0BAA0B;KACnC;IACD,aAAa,EAAE,yOAAyO;IACxP,WAAW,EAAE;QACX,8EAA8E;QAC9E,iEAAiE;QACjE,iJAAiJ;QACjJ,sEAAsE;QACtE,oGAAoG;QACpG,4EAA4E;KAC7E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,oDAAoD;SAC9D;QACD;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,iEAAiE;SAC3E;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,mCAAmC;SAC7C;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,iHAAiH;SAC3H;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+DAA+D;YAC3E,QAAQ,EAAE,wTAAwT;SACnU;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,8NAA8N;SACzO;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,mRAAmR;SAC9R;QACD;YACE,UAAU,EAAE,0BAA0B;YACtC,QAAQ,EAAE,kLAAkL;SAC7L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;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,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/cd.js

@@ -36,6 +36,7 @@ const builtinDoc = {
         "`cd(newFolder)` changes the working folder and returns the previous folder, enabling the classic MATLAB pattern `old = cd(new); ...; cd(old);`.",
         "Accepts character vectors and string scalars. String arrays must contain exactly one element. Other types raise `cd: folder name must be a character vector or string scalar`.",
         "Supports relative paths (for example `cd('..')`), absolute paths, and the shell-style `~` expansion to jump to the user home folder.",
+        "MATLAB command form is supported for path-like folder arguments, including `cd ..`, `cd ./data`, and `cd ~/project`.",
         "Emits descriptive errors when the folder does not exist or cannot be accessed.",
         "Does not modify GPU residency; path values always live on the host."
     ],
@@ -55,6 +56,11 @@ const builtinDoc = {
             "input": "old = cd(\"..\")",
             "output": "% RunMat moves to the parent folder and old captures the prior location"
         },
+        {
+            "description": "Navigate With MATLAB Command Syntax",
+            "input": "projectRoot = pwd;\nmkdir(\"scratch\");\ncd scratch\ncd ..\nbackAtRoot = strcmp(pwd, projectRoot)",
+            "output": "backAtRoot =\n  logical\n   1"
+        },
         {
             "description": "Switch To Your Home Folder With cd ~",
             "input": "old = cd(\"~\")",

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

@@ -1 +1 @@
-{"version":3,"file":"cd.js","sourceRoot":"","sources":["../../../src/generated/builtins/cd.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,IAAI;QACJ,kBAAkB;QAClB,gBAAgB;QAChB,mBAAmB;QACnB,KAAK;KACN;IACD,SAAS,EAAE,kEAAkE;IAC7E,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0IAA0I;KACpJ;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,6EAA6E;KAC7F;IACD,aAAa,EAAE,yLAAyL;IACxM,WAAW,EAAE;QACX,uGAAuG;QACvG,iJAAiJ;QACjJ,gLAAgL;QAChL,sIAAsI;QACtI,gFAAgF;QAChF,qEAAqE;KACtE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,wEAAwE;SACnF;QACD;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,qHAAqH;YAC9H,QAAQ,EAAE,8HAA8H;SACzI;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE,yEAAyE;SACpF;QACD;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,sEAAsE;SACjF;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,sFAAsF;YAC/F,QAAQ,EAAE,sEAAsE;SACjF;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,0EAA0E;YACnF,QAAQ,EAAE,+HAA+H;SAC1I;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,mJAAmJ;SAC9J;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,uFAAuF;SAClG;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,gMAAgM;SAC3M;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,oHAAoH;SAC/H;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,2GAA2G;SACtH;QACD;YACE,UAAU,EAAE,qDAAqD;YACjE,QAAQ,EAAE,wFAAwF;SACnG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,uDAAuD;QAChE,KAAK,EAAE,oGAAoG;KAC5G;IACD,eAAe,EAAE,oVAAoV;IACrW,cAAc,EAAE;QACd,ySAAyS;KAC1S;IACD,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"cd.js","sourceRoot":"","sources":["../../../src/generated/builtins/cd.ts"],"names":[],"mappings":"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"}

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

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

package/dist/generated/builtins/copyfile.js

@@ -39,6 +39,7 @@ const builtinDoc = {
         "`status = copyfile(source, destination)` copies a file or folder and returns `1` on success and `0` on failure.",
         "`[status, message, messageID] = copyfile(...)` adds MATLAB-style diagnostics. Successful copies return empty `1x0` character arrays.",
         "`copyfile(source, destination, 'f')` forces overwrites, matching MATLAB's `'f'` flag. Without the flag, existing destination files or folders prevent the copy.",
+        "MATLAB command form is supported for literal path arguments, including `copyfile ./source.m ./archive/source.m` and `copyfile ./source.m ./archive/source.m f`.",
         "Wildcards in `source` (for example, `*.m`) copy every match. When the pattern expands to multiple items, `destination` must be an existing folder; each match is copied into that folder.",
         "Folder copies replicate the entire directory tree, including nested files and subfolders, honoring read-only attributes where possible.",
         "Inputs accept character vectors or string scalars. Other types raise MATLAB-compatible errors before any filesystem work occurs.",

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

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

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

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

package/dist/generated/builtins/csvread.js

@@ -38,6 +38,7 @@ const builtinDoc = {
         "`csvread(filename, row, col, range)` reads only the rectangle described by `range`. Numeric ranges must contain four elements `[r1 c1 r2 c2]` (zero-based, inclusive). Excel-style ranges use the familiar `\"B2:D6\"` A1 notation, which RunMat converts to zero-based indices internally.",
         "Empty fields (two consecutive commas or a trailing comma) are interpreted as `0`. Tokens such as `NaN`, `Inf`, and `-Inf` are accepted (case-insensitive).",
         "Any other nonnumeric token raises an error that identifies the offending row and column.",
+        "File input is read as byte-oriented CSV text before numeric parsing, so non-UTF-8 bytes in skipped header rows or skipped label columns do not cause an I/O decoding failure.",
         "Results are dense double-precision tensors using column-major layout. An empty file produces a `0×0` tensor.",
         "Paths can contain `~` to reference the home directory; RunMat expands the token before opening the file."
     ],

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

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

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

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

package/dist/generated/builtins/diff.js

@@ -8,9 +8,10 @@ const builtinDoc = {
         "difference",
         "finite difference",
         "nth difference",
+        "symbolic derivative",
         "gpu"
     ],
-    "summary": "Compute forward finite differences in MATLAB and RunMat.",
+    "summary": "Compute forward finite differences or scalar symbolic derivatives in MATLAB and RunMat.",
     "references": [],
     "gpu_support": {
         "elementwise": false,
@@ -33,11 +34,12 @@ const builtinDoc = {
         "unit": "builtins::math::reduction::diff::tests",
         "integration": "builtins::math::reduction::diff::tests::diff_gpu_provider_roundtrip"
     },
-    "description": "`diff(X)` computes forward finite differences along the first non-singleton dimension by default. Higher-order and explicit-dimension forms follow MATLAB semantics.",
+    "description": "`diff(X)` computes forward finite differences along the first non-singleton dimension by default. Higher-order and explicit-dimension forms follow MATLAB semantics. When `X` is a scalar symbolic expression, `diff` builds a symbolic derivative expression.",
     "behaviors": [
         "`diff(X)` walks along the first non-singleton dimension. Column vectors therefore differentiate down the rows, while row vectors operate across columns.",
         "`diff(X, N)` computes the Nth forward difference. `N = 0` returns `X` unchanged. Each order reduces the length of the working dimension by one, so the output length becomes `max(len - N, 0)`.",
         "`diff(X, N, dim)` lets you choose the dimension explicitly. Passing `[]` for `N` or `dim` keeps the defaults, and dimensions larger than `ndims(X)` behave like length-1 axes (so any positive order yields an empty result).",
+        "For scalar symbolic inputs, `diff(expr, var)` and `diff(expr, var, N)` return symbolic derivative expressions. `diff(expr, N, var)` is accepted for MATLAB-compatible argument order.",
         "Real, logical, and character inputs promote to double precision tensors before differencing. Complex inputs retain their complex type, with forward differences applied to both the real and imaginary parts independently.",
         "Empty slices propagate: if the selected dimension has length 0 or 1, the corresponding axis in the output has length 0."
     ],
@@ -71,6 +73,11 @@ const builtinDoc = {
             "description": "Applying `diff` to character data",
             "input": "codes = diff('ACEG')",
             "output": "codes = [2 2 2]"
+        },
+        {
+            "description": "Build a symbolic derivative",
+            "input": "syms Y(X)\ndydx = diff(Y, X)",
+            "output": "dydx = diff(Y(X), X)"
         }
     ],
     "faqs": [
@@ -117,6 +124,10 @@ const builtinDoc = {
         {
             "question": "Does diff support GPU acceleration in RunMat?",
             "answer": "Yes. `diff` runs on GPU arrays in RunMat. The GPU path produces the same results as the CPU path for both real and complex inputs."
+        },
+        {
+            "question": "Does `diff` support symbolic expressions?",
+            "answer": "Yes. Scalar symbolic expressions return symbolic derivative expressions such as `diff(Y(X), X)`. Numeric arrays still use finite-difference semantics."
         }
     ],
     "links": [

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

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

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

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

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

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

@@ -0,0 +1,104 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "downsample",
+    "category": "math/signal",
+    "keywords": [
+        "downsample",
+        "sample rate",
+        "decimation",
+        "signal processing"
+    ],
+    "summary": "Decrease a signal's sample rate by keeping every Nth sample.",
+    "references": [
+        "title: \"MATLAB downsample documentation\""
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are accepted through the active provider gather path. The current implementation performs sample-rate conversion on the host and returns a host tensor."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::signal::sample_rate::tests",
+        "integration": "runmat-vm basics upsample_downsample_builtin_executes_for_discrete_signal_workflow"
+    },
+    "description": "`y = downsample(x, n)` keeps every `n`th sample of `x`, starting at the first sample, along the first non-singleton dimension. `y = downsample(x, n, phase)` starts at the zero-based `phase` offset.",
+    "behaviors": [
+        "Accepts numeric, logical, integer, complex, vector, matrix, N-D tensor, and GPU tensor inputs.",
+        "Operates along the first non-singleton dimension, matching MATLAB's column-wise behavior for matrices and row-wise behavior for row vectors.",
+        "`n` must be a finite positive integer scalar.",
+        "`phase` is optional, defaults to 0, and must be an integer scalar in the range `0 <= phase < n`.",
+        "The output keeps samples at zero-based positions `phase`, `phase + n`, `phase + 2*n`, and so on.",
+        "No anti-aliasing filter is applied; use filtering operations separately when decimating sampled signals."
+    ],
+    "examples": [
+        {
+            "description": "Keep every second row-vector sample",
+            "input": "x = [1 2 3 4 5];\ny = downsample(x, 2)",
+            "output": "y = [1 3 5]"
+        },
+        {
+            "description": "Start at the second sample with phase 1",
+            "input": "x = [1 2 3 4 5];\ny = downsample(x, 2, 1)",
+            "output": "y = [2 4]"
+        },
+        {
+            "description": "Downsample matrix columns",
+            "input": "X = [1 3; 2 4; 5 7];\nY = downsample(X, 2)",
+            "output": "Y = [1 3; 5 7]"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Which dimension does `downsample` use?",
+            "answer": "RunMat follows MATLAB's default and operates along the first non-singleton dimension."
+        },
+        {
+            "question": "Does `downsample` apply an anti-aliasing filter?",
+            "answer": "No. `downsample` only selects samples. Apply a low-pass filter first when anti-aliasing is required."
+        },
+        {
+            "question": "Can I pass GPU tensors?",
+            "answer": "Yes. GPU inputs are gathered through the active provider, converted on the host, and returned as host tensors."
+        }
+    ],
+    "links": [
+        {
+            "label": "upsample",
+            "url": "./upsample"
+        },
+        {
+            "label": "filter",
+            "url": "./filter"
+        },
+        {
+            "label": "stem",
+            "url": "./stem"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/signal/sample_rate.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/signal/sample_rate.rs"
+    },
+    "key": "downsample",
+    "slug": "downsample",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "signal"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=downsample.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"downsample.js","sourceRoot":"","sources":["../../../src/generated/builtins/downsample.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,YAAY;QACZ,aAAa;QACb,YAAY;QACZ,mBAAmB;KACpB;IACD,SAAS,EAAE,8DAA8D;IACzE,YAAY,EAAE;QACZ,4CAA4C;KAC7C;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,oKAAoK;KAC9K;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,4CAA4C;QACpD,aAAa,EAAE,oFAAoF;KACpG;IACD,aAAa,EAAE,uMAAuM;IACtN,WAAW,EAAE;QACX,gGAAgG;QAChG,8IAA8I;QAC9I,+CAA+C;QAC/C,kGAAkG;QAClG,kGAAkG;QAClG,0GAA0G;KAC3G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,wCAAwC;YACjD,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE,WAAW;SACtB;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,4CAA4C;YACrD,QAAQ,EAAE,gBAAgB;SAC3B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,uFAAuF;SAClG;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,sGAAsG;SACjH;QACD;YACE,UAAU,EAAE,yBAAyB;YACrC,QAAQ,EAAE,gHAAgH;SAC3H;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;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,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/eq.js

@@ -8,6 +8,7 @@ const builtinDoc = {
         "==",
         "equality",
         "logical comparison",
+        "symbolic equation",
         "gpuArray equality"
     ],
     "summary": "Compute element-wise equality in MATLAB and RunMat.",
@@ -34,12 +35,13 @@ const builtinDoc = {
         "integration": "builtins::logical::rel::eq::tests::eq_gpu_provider_roundtrip",
         "gpu": "builtins::logical::rel::eq::tests::eq_wgpu_matches_host"
     },
-    "description": "`eq(A, B)` (or `A == B`) compares inputs element-wise for equality. Scalar expansion and output-shape behavior follow MATLAB and RunMat logical comparison semantics.",
+    "description": "`eq(A, B)` (or `A == B`) compares inputs element-wise for equality. Scalar expansion and output-shape behavior follow MATLAB and RunMat logical comparison semantics. When either operand is symbolic, equality constructs a symbolic equation.",
     "behaviors": [
         "Numeric, logical, and character inputs are compared element-wise using MATLAB's implicit expansion rules.",
         "Complex numbers are equal only when both their real and imaginary parts match.",
         "Character arrays compare by Unicode code point; you can mix them with numeric arrays (`'A' == 65`) or strings.",
         "String scalars and string arrays compare lexically; implicit expansion works across the string dimensions.",
+        "Symbolic scalar operands return symbolic equations, for example `Y(0) == 0`, instead of logical truth values.",
         "Handle objects compare by identity rather than by structural equality.",
         "Mixed numeric/string inputs raise MATLAB-compatible type errors."
     ],
@@ -73,6 +75,11 @@ const builtinDoc = {
             "description": "Run `eq` Directly On `gpuArray` Inputs",
             "input": "G1 = gpuArray([1 2 3]);\nG2 = gpuArray([1 0 3]);\ndeviceResult = eq(G1, G2)\nhostResult = gather(deviceResult)",
             "output": "deviceResult =\n  1  0  1\nhostResult =\n  1  0  1"
+        },
+        {
+            "description": "Create a symbolic equation",
+            "input": "syms Y(X)\ncond = Y(0) == 0",
+            "output": "cond = Y(0) == 0"
         }
     ],
     "faqs": [
@@ -107,6 +114,10 @@ const builtinDoc = {
         {
             "question": "Can I chain `eq` inside fused GPU expressions?",
             "answer": "Yes. The builtin registers element-wise fusion metadata so the planner can fuse comparisons with surrounding GPU-friendly operations."
+        },
+        {
+            "question": "What happens when one operand is symbolic?",
+            "answer": "`eq` returns a scalar symbolic equation. It does not try to decide whether the equation is true unless both operands are handled by the ordinary numeric or logical comparison paths."
         }
     ],
     "links": [

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

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

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

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

package/dist/generated/builtins/figure.js

@@ -20,20 +20,28 @@ const builtinDoc = {
     "fusion": {
         "elementwise": false,
         "reduction": false,
-        "max_inputs": 1,
+        "max_inputs": null,
         "constants": "inline"
     },
     "requires_feature": null,
     "tested": {
         "integration": "runmat-plot/tests/renderer_tests.rs"
     },
-    "description": "`figure` creates a new plotting figure or selects an existing one as current. With no arguments (or `'next'`) it allocates a fresh handle; passing a positive numeric handle selects that figure, creating it if needed. Handle selection and creation behavior follow MATLAB semantics.",
+    "description": "`figure` creates a new plotting figure or selects an existing one as current. With no arguments (or `'next'`) it allocates a fresh handle; passing a positive numeric handle selects that figure, creating it if needed. `figure` also accepts figure property/value pairs such as `'Name'`, `'NumberTitle'`, `'Visible'`, and `'Color'`. Handle selection, creation, and property assignment behavior follow MATLAB semantics.",
     "behaviors": [
         "`figure()` creates a new figure and returns its numeric handle.",
         "`figure(n)` selects figure `n`. If that handle does not exist yet, RunMat creates it.",
         "`figure('next')` creates a new figure instead of selecting an existing one.",
+        "`figure('Property', value, ...)` creates a fresh figure and applies the requested figure properties.",
+        "`figure(n, 'Property', value, ...)` selects or creates figure `n` and applies the requested figure properties.",
         "The selected figure becomes the target for subsequent plotting commands such as `plot`, `subplot`, `gca`, `clf`, and `hold`."
     ],
+    "options": [
+        "`'Name'` sets the figure window name and can be inspected later with `get(f, 'Name')`.",
+        "`'NumberTitle'` accepts logical values or MATLAB-style `'on'`/`'off'` strings.",
+        "`'Visible'` accepts logical values or MATLAB-style `'on'`/`'off'` strings. Hidden figures keep their graphics state but do not open or update interactive windows until made visible again.",
+        "`'Color'` and `'BackgroundColor'` accept exact MATLAB color letters, full color names such as `'black'`, or RGB triples, and update the figure background color."
+    ],
     "examples": [
         {
             "description": "Create a fresh figure",
@@ -49,6 +57,11 @@ const builtinDoc = {
             "description": "Select a specific figure handle",
             "input": "figure(3);\nplot(1:5, [1 4 2 5 3]);",
             "output": "% plotting now targets figure 3"
+        },
+        {
+            "description": "Create a named figure with MATLAB-style property pairs",
+            "input": "f = figure('Name', 'demo', 'NumberTitle', 'off', 'Visible', 'off');\nplot(1:5, [1 4 2 5 3]);",
+            "output": "% f is a figure handle whose Name, NumberTitle, and Visible properties are set"
         }
     ],
     "faqs": [
@@ -60,6 +73,10 @@ const builtinDoc = {
             "question": "What does `figure('next')` do?",
             "answer": "It forces creation of a new figure rather than reusing an existing handle."
         },
+        {
+            "question": "Can `figure` set window properties at creation time?",
+            "answer": "Yes. Pass alternating property/value pairs, either directly or after a numeric handle: `figure('Name', 'demo')` or `figure(3, 'Name', 'demo', 'NumberTitle', 'off')`."
+        },
         {
             "question": "Does `figure` draw anything by itself?",
             "answer": "No. It only manages the active figure selection. Plotting happens when you call builtins like `plot`, `scatter`, or `surf`."

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

@@ -1 +1 @@
-{"version":3,"file":"figure.js","sourceRoot":"","sources":["../../../src/generated/builtins/figure.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,UAAU;QACV,iBAAiB;QACjB,kBAAkB;KACnB;IACD,SAAS,EAAE,yDAAyD;IACpE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,uFAAuF;KACjG;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,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,0RAA0R;IACzS,WAAW,EAAE;QACX,iEAAiE;QACjE,uFAAuF;QACvF,6EAA6E;QAC7E,8HAA8H;KAC/H;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,yCAAyC;SACpD;QACD;YACE,aAAa,EAAE,yDAAyD;YACxE,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,2CAA2C;SACtD;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,qCAAqC;YAC9C,QAAQ,EAAE,iCAAiC;SAC5C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uDAAuD;YACnE,QAAQ,EAAE,oEAAoE;SAC/E;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,4EAA4E;SACvF;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,6HAA6H;SACxI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;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,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,eAAe,EAAE,kHAAkH;IACnI,cAAc,EAAE;QACd,6JAA6J;KAC9J;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"figure.js","sourceRoot":"","sources":["../../../src/generated/builtins/figure.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,UAAU;QACV,iBAAiB;QACjB,kBAAkB;KACnB;IACD,SAAS,EAAE,yDAAyD;IACpE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,uFAAuF;KACjG;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,iaAAia;IAChb,WAAW,EAAE;QACX,iEAAiE;QACjE,uFAAuF;QACvF,6EAA6E;QAC7E,sGAAsG;QACtG,gHAAgH;QAChH,8HAA8H;KAC/H;IACD,SAAS,EAAE;QACT,wFAAwF;QACxF,gFAAgF;QAChF,6LAA6L;QAC7L,kKAAkK;KACnK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,yCAAyC;SACpD;QACD;YACE,aAAa,EAAE,yDAAyD;YACxE,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,2CAA2C;SACtD;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,qCAAqC;YAC9C,QAAQ,EAAE,iCAAiC;SAC5C;QACD;YACE,aAAa,EAAE,wDAAwD;YACvE,OAAO,EAAE,8FAA8F;YACvG,QAAQ,EAAE,gFAAgF;SAC3F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uDAAuD;YACnE,QAAQ,EAAE,oEAAoE;SAC/E;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,4EAA4E;SACvF;QACD;YACE,UAAU,EAAE,sDAAsD;YAClE,QAAQ,EAAE,uKAAuK;SAClL;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,6HAA6H;SACxI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;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,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,eAAe,EAAE,kHAAkH;IACnI,cAAc,EAAE;QACd,6JAA6J;KAC9J;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/fzero.d.ts.map

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

package/dist/generated/builtins/fzero.js

@@ -28,13 +28,16 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::math::optim::fzero::tests",
-        "integration": "runmat-vm/tests/closures.rs::fzero_accepts_anonymous_function"
+        "integration": "runmat-vm/tests/closures.rs::fzero_returns_optional_function_value"
     },
-    "description": "`x = fzero(fun, x0)` searches near scalar initial point `x0` for a sign-changing bracket, then refines the root with a Brent-style method. `x = fzero(fun, [a b])` uses the supplied bracket directly, with tolerance, exit flag, and diagnostic behavior matching MATLAB semantics.",
+    "description": "`x = fzero(fun, x0)` searches near scalar initial point `x0` for a sign-changing bracket, then refines the root with a Brent-style method. `x = fzero(fun, [a b])` uses the supplied bracket directly. Optional outputs follow MATLAB's standard contract: `[x, fval]`, `[x, fval, exitflag]`, and `[x, fval, exitflag, output]`.",
     "behaviors": [
         "The function handle must return a finite real scalar.",
         "Bracket endpoints must have opposite signs unless one endpoint is already a root.",
         "Options are supplied as a struct, usually created with `optimset`. `TolX`, `MaxIter`, `MaxFunEvals`, and `Display` are accepted.",
+        "`fval` is the function value at the returned `x`; `exitflag` is 1 for convergence and 0 when the iteration/function-evaluation budget is exhausted.",
+        "The four-output `output` struct contains `iterations`, `funcCount`, `algorithm`, and `message` fields.",
+        "Requests for more than four outputs are rejected.",
         "Anonymous functions, named function handles, and function-handle strings work through RunMat's existing `feval` dispatch path."
     ],
     "examples": [
@@ -48,6 +51,11 @@ const builtinDoc = {
             "input": "x = fzero(@sin, [3 4])",
             "output": "x =\n    3.1416"
         },
+        {
+            "description": "Return the root and function value",
+            "input": "f = @(x) x.^2 - 4;\n[x, fval] = fzero(f, [0 3])",
+            "output": "x =\n    2.0000\nfval =\n     0"
+        },
         {
             "description": "Set a tighter tolerance",
             "input": "opts = optimset('TolX', 1e-10, 'Display', 'off');\nx = fzero(@sin, [3 4], opts)",

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

@@ -1 +1 @@
-{"version":3,"file":"fzero.js","sourceRoot":"","sources":["../../../src/generated/builtins/fzero.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,OAAO;QACP,cAAc;QACd,MAAM;QACN,OAAO;QACP,cAAc;KACf;IACD,SAAS,EAAE,8EAA8E;IACzF,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,oFAAoF;KAC9F;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;QAC7C,aAAa,EAAE,+DAA+D;KAC/E;IACD,aAAa,EAAE,sRAAsR;IACrS,WAAW,EAAE;QACX,uDAAuD;QACvD,mFAAmF;QACnF,kIAAkI;QAClI,gIAAgI;KACjI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yCAAyC;YAClD,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,wBAAwB;YACjC,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,iFAAiF;YAC1F,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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,0DAA0D;QACnE,KAAK,EAAE,uGAAuG;KAC/G;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"fzero.js","sourceRoot":"","sources":["../../../src/generated/builtins/fzero.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,OAAO;QACP,cAAc;QACd,MAAM;QACN,OAAO;QACP,cAAc;KACf;IACD,SAAS,EAAE,8EAA8E;IACzF,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,oFAAoF;KAC9F;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;QAC7C,aAAa,EAAE,oEAAoE;KACpF;IACD,aAAa,EAAE,mUAAmU;IAClV,WAAW,EAAE;QACX,uDAAuD;QACvD,mFAAmF;QACnF,kIAAkI;QAClI,qJAAqJ;QACrJ,wGAAwG;QACxG,mDAAmD;QACnD,gIAAgI;KACjI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yCAAyC;YAClD,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,wBAAwB;YACjC,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,iDAAiD;YAC1D,QAAQ,EAAE,iCAAiC;SAC5C;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,iFAAiF;YAC1F,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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,0DAA0D;QACnE,KAAK,EAAE,uGAAuG;KAC/G;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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