runmat 0.4.3 → 0.4.4-dev.0

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

@@ -1 +1 @@
-{"version":3,"file":"stem.js","sourceRoot":"","sources":["../../../src/generated/builtins/stem.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,WAAW;QACX,sBAAsB;QACtB,wBAAwB;QACxB,aAAa;KACd;IACD,SAAS,EAAE,8FAA8F;IACzG,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,0HAA0H;KACpI;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,iCAAiC;QACzC,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,oWAAoW;IACnX,WAAW,EAAE;QACX,8FAA8F;QAC9F,2EAA2E;QAC3E,mIAAmI;QACnI,0FAA0F;QAC1F,sIAAsI;KACvI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,oBAAoB;SAC9B;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,mGAAmG;SAC7G;QACD;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,6CAA6C;YACtD,QAAQ,EAAE,mBAAmB;SAC9B;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,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,eAAe,EAAE,iIAAiI;IAClJ,cAAc,EAAE;QACd,gFAAgF;QAChF,iHAAiH;KAClH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"stem.js","sourceRoot":"","sources":["../../../src/generated/builtins/stem.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,WAAW;QACX,sBAAsB;QACtB,wBAAwB;QACxB,aAAa;KACd;IACD,SAAS,EAAE,8FAA8F;IACzG,YAAY,EAAE,iGAAiG;IAC/G,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,0HAA0H;KACpI;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,iCAAiC;QACzC,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,oWAAoW;IACnX,WAAW,EAAE;QACX,8FAA8F;QAC9F,2EAA2E;QAC3E,mIAAmI;QACnI,0FAA0F;QAC1F,sIAAsI;KACvI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,oBAAoB;SAC9B;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,mGAAmG;SAC7G;QACD;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,6CAA6C;YACtD,QAAQ,EAAE,mBAAmB;SAC9B;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,wJAAwJ;YACjK,YAAY,EAAE,iGAAiG;SAChH;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,kXAAkX;SAC7X;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,4VAA4V;SACvW;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,yPAAyP;SACpQ;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,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;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,eAAe,EAAE,iIAAiI;IAClJ,cAAc,EAAE;QACd,gFAAgF;QAChF,iHAAiH;KAClH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/strcat.js

@@ -49,8 +49,8 @@ const builtinDoc = {
         },
         {
             "description": "Concatenate a string scalar with a string array",
-            "input": "names = [\"Ignition\", \"Turbine\", \"Accelerate\"];\ntagged = strcat(\"runmat-\", names)",
-            "output": "tagged = 1×3 string\n    \"runmat-Ignition\"    \"runmat-Turbine\"    \"runmat-Accelerate\""
+            "input": "names = [\"VM\", \"Turbine\", \"Accelerate\"];\ntagged = strcat(\"runmat-\", names)",
+            "output": "tagged = 1×3 string\n    \"runmat-VM\"    \"runmat-Turbine\"    \"runmat-Accelerate\""
         },
         {
             "description": "Concatenate character arrays while trimming trailing spaces",

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"strcmpi.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/strcmpi.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAgLjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"strcmpi.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/strcmpi.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/strcmpi.js

@@ -98,6 +98,18 @@ const builtinDoc = {
         {
             "question": "What is returned when both inputs are scalars?",
             "answer": "A logical scalar is returned (`true` or `false`). For non-scalar shapes, a logical array that mirrors the broadcast dimensions is produced."
+        },
+        {
+            "question": "What is `strcmpi` in MATLAB?",
+            "answer": "— `strcmpi(s1, s2)` compares two text values for equality while ignoring letter case. It returns `true` when the strings match case-insensitively and `false` otherwise. The `i` stands for *insensitive*. Use `strcmp` when you do want case to matter, and `strncmpi` when you only want to compare the first `n` characters."
+        },
+        {
+            "question": "How does `strcmpi` behave with cell arrays or string arrays?",
+            "answer": "— When one operand is a cell array or string array and the other is a scalar, `strcmpi` broadcasts the scalar elementwise and returns a logical array of the same shape. For example:\n\n```matlab\nstrcmpi({'apple','Banana','CHERRY'}, 'banana')\n% ans =  1x3 logical array\n%   0   1   0\n```\n\nWhen both operands are arrays of the same shape, they are compared element-by-element. This matches MATLAB's implicit-expansion rules."
+        },
+        {
+            "question": "Does `strcmpi` work across mixed char/string inputs?",
+            "answer": "— Yes. Character vectors (`'Hello'`), string scalars (`\"Hello\"`), and cells of character vectors all interoperate, so `strcmpi('hello', \"Hello\")` returns `true`. Note that `strcmpi` only tests **exact equality** (ignoring case). For case-insensitive *substring* matching, use `contains(str, pattern, 'IgnoreCase', true)` or `regexpi`."
         }
     ],
     "links": [
@@ -170,6 +182,18 @@ const builtinDoc = {
     "gpu_behavior": [
         "`strcmpi` is registered as an acceleration sink. When either operand resides on the GPU, RunMat gathers both to host memory before comparing them. This keeps behaviour identical to MATLAB and avoids requiring backend-specific kernels. The logical result is produced on the CPU and never remains GPU-resident."
     ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "tf = strcmpi(s1, s2)"
+        },
+        "points": [
+            "`s1` and `s2` are the text values to compare. Accepted types: character vector (`'abc'`), character matrix (`char(...)`), string scalar or array (`\"abc\"`, `[\"a\" \"b\"]`), or cell array of character vectors (`{'a','b'}`). Types can be mixed — `strcmpi('hello', \"Hello\")` returns `true`.",
+            "When one operand is a scalar (a single string or `1×1` cell/string) and the other is an array/cell of strings, MATLAB broadcasts the scalar elementwise across the array. For same-shape arrays, comparison is elementwise.",
+            "Returns `tf`, a logical scalar when both inputs are scalars, or a logical array whose shape matches the broadcast result. `missing` string values always compare unequal, mirroring MATLAB.",
+            "For exact (case-sensitive) equality use `strcmp`. For case-insensitive *substring* matching (rather than full equality), use `contains(s, pattern, 'IgnoreCase', true)` or `regexpi`."
+        ]
+    },
     "key": "strcmpi",
     "slug": "strcmpi",
     "categoryPath": [

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

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

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

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

package/dist/generated/builtins/subplot.js

@@ -38,6 +38,20 @@ const builtinDoc = {
             "output": "% Only the first subplot uses a logarithmic x-axis"
         }
     ],
+    "faqs": [
+        {
+            "question": "How do I control the number of rows and columns in a subplot layout?",
+            "answer": "The first two arguments to `subplot(m, n, p)` set the grid dimensions: `m` rows and `n` columns. The third argument `p` selects which slot to activate, counted in row-major order starting at 1. `subplot(3, 1, 2)` gives you the middle row of a three-row single-column layout."
+        },
+        {
+            "question": "Can two subplots share the same x-axis range?",
+            "answer": "Set matching limits on both axes manually with `axis` or `set`. There's no automatic `linkaxes` yet, but explicit limits keep them in sync.\n\n```matlab\nsubplot(2, 1, 1); plot(0:10, rand(1, 11)); axis([0 10 0 1]);\nsubplot(2, 1, 2); plot(0:10, rand(1, 11)); axis([0 10 0 1]);\n```"
+        },
+        {
+            "question": "Can I make subplots of unequal sizes?",
+            "answer": "You can span multiple grid slots by passing a vector as the third argument. `subplot(2, 2, [1 2])` creates a subplot that spans the entire top row of a 2x2 grid, while the bottom row keeps two separate panels."
+        }
+    ],
     "links": [
         {
             "label": "plot",
@@ -54,6 +68,22 @@ const builtinDoc = {
         {
             "label": "set",
             "url": "./set"
+        },
+        {
+            "label": "Choosing the right plot type",
+            "url": "/docs/plotting/choosing-the-right-plot-type"
+        },
+        {
+            "label": "Styling plots and axes",
+            "url": "/docs/plotting/styling-plots-and-axes"
+        },
+        {
+            "label": "Plot replay and export",
+            "url": "/docs/plotting/plot-replay-and-export"
+        },
+        {
+            "label": "Complete plotting guide",
+            "url": "/blog/matlab-plotting-guide"
         }
     ],
     "source": {

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

@@ -1 +1 @@
-{"version":3,"file":"subplot.js","sourceRoot":"","sources":["../../../src/generated/builtins/subplot.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,SAAS;QACT,cAAc;QACd,mBAAmB;QACnB,gBAAgB;QAChB,eAAe;KAChB;IACD,SAAS,EAAE,qHAAqH;IAChI,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,oCAAoC;KAC7C;IACD,aAAa,EAAE,6UAA6U;IAC5V,WAAW,EAAE;QACX,gGAAgG;QAChG,uIAAuI;QACvI,+GAA+G;QAC/G,0GAA0G;KAC3G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,gGAAgG;SAC1G;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,2EAA2E;YACpF,QAAQ,EAAE,mBAAmB;SAC9B;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,0GAA0G;YACnH,QAAQ,EAAE,oDAAoD;SAC/D;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"subplot.js","sourceRoot":"","sources":["../../../src/generated/builtins/subplot.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,SAAS;QACT,cAAc;QACd,mBAAmB;QACnB,gBAAgB;QAChB,eAAe;KAChB;IACD,SAAS,EAAE,qHAAqH;IAChI,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,oCAAoC;KAC7C;IACD,aAAa,EAAE,6UAA6U;IAC5V,WAAW,EAAE;QACX,gGAAgG;QAChG,uIAAuI;QACvI,+GAA+G;QAC/G,0GAA0G;KAC3G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,gGAAgG;SAC1G;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,2EAA2E;YACpF,QAAQ,EAAE,mBAAmB;SAC9B;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,0GAA0G;YACnH,QAAQ,EAAE,oDAAoD;SAC/D;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sEAAsE;YAClF,QAAQ,EAAE,oRAAoR;SAC/R;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,2RAA2R;SACtS;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,mNAAmN;SAC9N;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;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,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/surf.js

@@ -12,6 +12,7 @@ const builtinDoc = {
         "gpu surface rendering"
     ],
     "summary": "Create shaded 3-D surface plots from grids or mesh coordinates with GPU-backed rendering and MATLAB `surf` semantics.",
+    "hero_image": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-surf-damped-radial-ripple.webp",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
@@ -54,6 +55,25 @@ const builtinDoc = {
             "description": "Adjust camera state and z-axis labeling for a surface",
             "input": "[X, Y] = meshgrid(linspace(-2, 2, 60), linspace(-2, 2, 60));\nZ = X .* exp(-X.^2 - Y.^2);\nh = surf(X, Y, Z);\nzlabel('Height');\nview(45, 30);\nget(h, 'Type')",
             "output": "ans =\n    'surface'"
+        },
+        {
+            "description": "Damped radial ripple with interpolated shading",
+            "input": "[X, Y] = meshgrid(linspace(-4, 4, 200), linspace(-4, 4, 200));\nR = sqrt(X.^2 + Y.^2) + 0.01;\nZ = sin(3*R) ./ R;\n\nsurf(X, Y, Z);\nshading interp;\ncolormap('turbo');\ncolorbar;\ntitle('Damped Radial Wavefield');\nxlabel('x');\nylabel('y');\nzlabel('Amplitude');\nview(35, 25);",
+            "image_webp": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-surf-damped-radial-ripple.webp"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How do I change the colormap on a surf plot?",
+            "answer": "Call `colormap` after `surf` to swap the palette. The colormap applies to the current axes, so it works per-subplot.\n\n```matlab\nsurf(X, Y, Z);\ncolormap('turbo');\n```\n\nAny named colormap (`'parula'`, `'jet'`, `'hot'`, etc.) or an Nx3 matrix of RGB values works here."
+        },
+        {
+            "question": "How do I rotate or set the 3-D viewing angle?",
+            "answer": "Use `view(az, el)` where `az` is the azimuth in degrees and `el` is the elevation. For example, `view(45, 30)` gives you a 45-degree orbit at 30 degrees above the xy-plane. `view(3)` is a shortcut for the default 3-D perspective, and `view(2)` snaps to a top-down 2-D projection."
+        },
+        {
+            "question": "What's the difference between surf and mesh?",
+            "answer": "`surf` renders a shaded, filled surface where face colors come from the colormap. `mesh` draws only the wireframe grid lines with no face fill. Use `surf` when you want to visualize the shape as a solid surface, and `mesh` when you want to see through the geometry to understand the grid structure underneath."
         }
     ],
     "links": [
@@ -84,6 +104,22 @@ const builtinDoc = {
         {
             "label": "colorbar",
             "url": "./colorbar"
+        },
+        {
+            "label": "Choosing the right plot type",
+            "url": "/docs/plotting/choosing-the-right-plot-type"
+        },
+        {
+            "label": "Styling plots and axes",
+            "url": "/docs/plotting/styling-plots-and-axes"
+        },
+        {
+            "label": "Plot replay and export",
+            "url": "/docs/plotting/plot-replay-and-export"
+        },
+        {
+            "label": "Complete plotting guide",
+            "url": "/blog/matlab-plotting-guide"
         }
     ],
     "source": {

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

@@ -1 +1 @@
-{"version":3,"file":"surf.js","sourceRoot":"","sources":["../../../src/generated/builtins/surf.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,cAAc;QACd,aAAa;QACb,YAAY;QACZ,aAAa;QACb,uBAAuB;KACxB;IACD,SAAS,EAAE,uHAAuH;IAClI,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,kJAAkJ;KAC5J;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,iCAAiC;QACzC,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,oVAAoV;IACnW,WAAW,EAAE;QACX,2JAA2J;QAC3J,mGAAmG;QACnG,8JAA8J;QAC9J,+MAA+M;QAC/M,iJAAiJ;KAClJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,0HAA0H;SACpI;QACD;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,qJAAqJ;SAC/J;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,iKAAiK;YAC1K,QAAQ,EAAE,sBAAsB;SACjC;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,eAAe,EAAE,uQAAuQ;IACxR,cAAc,EAAE;QACd,+JAA+J;QAC/J,iJAAiJ;KAClJ;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"surf.js","sourceRoot":"","sources":["../../../src/generated/builtins/surf.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,cAAc;QACd,aAAa;QACb,YAAY;QACZ,aAAa;QACb,uBAAuB;KACxB;IACD,SAAS,EAAE,uHAAuH;IAClI,YAAY,EAAE,8FAA8F;IAC5G,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,kJAAkJ;KAC5J;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,iCAAiC;QACzC,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,oVAAoV;IACnW,WAAW,EAAE;QACX,2JAA2J;QAC3J,mGAAmG;QACnG,8JAA8J;QAC9J,+MAA+M;QAC/M,iJAAiJ;KAClJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,0HAA0H;SACpI;QACD;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,qJAAqJ;SAC/J;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,iKAAiK;YAC1K,QAAQ,EAAE,sBAAsB;SACjC;QACD;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,yRAAyR;YAClS,YAAY,EAAE,8FAA8F;SAC7G;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,kRAAkR;SAC7R;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,yRAAyR;SACpS;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,uTAAuT;SAClU;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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,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,eAAe,EAAE,uQAAuQ;IACxR,cAAc,EAAE;QACd,+JAA+J;QAC/J,iJAAiJ;KAClJ;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/surfc.js

@@ -54,6 +54,20 @@ const builtinDoc = {
             "output": "ans =\n    'surface'"
         }
     ],
+    "faqs": [
+        {
+            "question": "Where do the contour lines appear in a surfc plot?",
+            "answer": "The contour lines are projected onto the base plane (the z-minimum of the axes). They sit below the surface as a 2-D footprint of the height field. The contour overlay uses the same colormap as the surface, so the colors stay consistent."
+        },
+        {
+            "question": "When should I use surfc vs calling surf and contour separately?",
+            "answer": "`surfc` handles the composite in one call — the contour is automatically projected to the base plane and shares the surface's colormap and axes state. If you call `surf` and `contour` separately, the contour sits at z=0 by default and you'd need to manage hold state and z-placement yourself. Use `surfc` unless you need the contour at a custom z-level or with different level spacing than the default."
+        },
+        {
+            "question": "Can I control how many contour levels surfc draws?",
+            "answer": "The contour overlay in `surfc` uses the default level-generation logic from the contour pipeline. If you need explicit control over level count or spacing, call `surf` and `contour` separately so you can pass a level vector to `contour` directly."
+        }
+    ],
     "links": [
         {
             "label": "surf",
@@ -74,6 +88,22 @@ const builtinDoc = {
         {
             "label": "view",
             "url": "./view"
+        },
+        {
+            "label": "Choosing the right plot type",
+            "url": "/docs/plotting/choosing-the-right-plot-type"
+        },
+        {
+            "label": "Styling plots and axes",
+            "url": "/docs/plotting/styling-plots-and-axes"
+        },
+        {
+            "label": "Plot replay and export",
+            "url": "/docs/plotting/plot-replay-and-export"
+        },
+        {
+            "label": "Complete plotting guide",
+            "url": "/blog/matlab-plotting-guide"
         }
     ],
     "source": {

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

@@ -1 +1 @@
-{"version":3,"file":"surfc.js","sourceRoot":"","sources":["../../../src/generated/builtins/surfc.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,OAAO;QACP,sBAAsB;QACtB,wBAAwB;QACxB,2BAA2B;QAC3B,cAAc;KACf;IACD,SAAS,EAAE,4HAA4H;IACvI,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,yIAAyI;KACnJ;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;KAC3C;IACD,aAAa,EAAE,yXAAyX;IACxY,WAAW,EAAE;QACX,qFAAqF;QACrF,kJAAkJ;QAClJ,gIAAgI;QAChI,6HAA6H;QAC7H,4FAA4F;KAC7F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sDAAsD;YACrE,OAAO,EAAE,4GAA4G;SACtH;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,wJAAwJ;SAClK;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,iFAAiF;YAC1F,QAAQ,EAAE,sBAAsB;SACjC;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,4DAA4D;QACrE,KAAK,EAAE,yGAAyG;KACjH;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"surfc.js","sourceRoot":"","sources":["../../../src/generated/builtins/surfc.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,OAAO;QACP,sBAAsB;QACtB,wBAAwB;QACxB,2BAA2B;QAC3B,cAAc;KACf;IACD,SAAS,EAAE,4HAA4H;IACvI,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,yIAAyI;KACnJ;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;KAC3C;IACD,aAAa,EAAE,yXAAyX;IACxY,WAAW,EAAE;QACX,qFAAqF;QACrF,kJAAkJ;QAClJ,gIAAgI;QAChI,6HAA6H;QAC7H,4FAA4F;KAC7F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sDAAsD;YACrE,OAAO,EAAE,4GAA4G;SACtH;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,wJAAwJ;SAClK;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,iFAAiF;YAC1F,QAAQ,EAAE,sBAAsB;SACjC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,+OAA+O;SAC1P;QACD;YACE,UAAU,EAAE,iEAAiE;YAC7E,QAAQ,EAAE,oZAAoZ;SAC/Z;QACD;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,wPAAwP;SACnQ;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;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,4DAA4D;QACrE,KAAK,EAAE,yGAAyG;KACjH;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/trapz.js

@@ -0,0 +1,129 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "trapz",
+    "category": "math/reduction",
+    "keywords": [
+        "trapz",
+        "trapezoidal integration",
+        "numerical integration",
+        "discrete integration",
+        "gpu"
+    ],
+    "summary": "Trapezoidal numerical integration of sampled data.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "GPU inputs currently gather to the host for trapezoidal integration and re-upload real-valued outputs so downstream code can remain device-resident."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::reduction::trapz::tests"
+    },
+    "description": "`trapz(Y)` approximates the integral of sampled data in `Y` using the trapezoidal rule. The integration runs along the first non-singleton dimension unless you specify a different dimension explicitly.",
+    "behaviors": [
+        "`trapz(Y)` assumes unit spacing between adjacent samples.",
+        "`trapz(X, Y)` accepts a scalar spacing, a vector of coordinates whose length matches the working dimension, or an array `X` with the same size as `Y`.",
+        "`trapz(..., dim)` selects the working dimension explicitly. Dimensions larger than `ndims(Y)` behave like singleton axes, so the result is zero along those slices.",
+        "Logical inputs are promoted to double precision before integration. Complex-valued `Y` inputs are integrated component-wise and preserve their complex output type.",
+        "When the selected dimension has length 0 or 1, `trapz` returns zeros because there are no intervals to integrate."
+    ],
+    "examples": [
+        {
+            "description": "Integrating sampled sine data with explicit coordinates",
+            "input": "x = 0:0.01:pi;\ny = sin(x);\narea = trapz(x, y)",
+            "output": "area ≈ 2"
+        },
+        {
+            "description": "Using unit spacing for a row vector",
+            "input": "y = [1 2 3];\nq = trapz(y)",
+            "output": "q = 4"
+        },
+        {
+            "description": "Integrating each row independently",
+            "input": "A = [1 2 3; 4 5 6];\nq = trapz(A, 2)",
+            "output": "q =\n     4\n    10"
+        },
+        {
+            "description": "Running trapz on GPU data",
+            "input": "G = gpuArray([1 2 3]);\nq = trapz(G);\nresult = gather(q)",
+            "output": "result = 4"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What spacing does `trapz(Y)` assume?",
+            "answer": "It assumes adjacent samples are one unit apart."
+        },
+        {
+            "question": "What forms of `X` are accepted?",
+            "answer": "A scalar spacing, a vector of coordinates matching the integration dimension, or an array with the same size as `Y`."
+        },
+        {
+            "question": "What happens for a scalar or singleton slice?",
+            "answer": "The integral is zero because there are no trapezoids to sum."
+        },
+        {
+            "question": "Does trapz support complex inputs?",
+            "answer": "Yes. RunMat integrates the real and imaginary parts independently and returns a complex result."
+        },
+        {
+            "question": "Does trapz keep gpuArray residency?",
+            "answer": "For real-valued results, yes. RunMat currently gathers GPU inputs to the host, computes the trapezoidal integral, and re-uploads the result so downstream GPU code can stay resident."
+        }
+    ],
+    "links": [
+        {
+            "label": "cumtrapz",
+            "url": "./cumtrapz"
+        },
+        {
+            "label": "diff",
+            "url": "./diff"
+        },
+        {
+            "label": "sum",
+            "url": "./sum"
+        },
+        {
+            "label": "cumsum",
+            "url": "./cumsum"
+        },
+        {
+            "label": "gpuArray",
+            "url": "./gpuarray"
+        },
+        {
+            "label": "gather",
+            "url": "./gather"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/reduction/trapz.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/reduction/trapz.rs"
+    },
+    "gpu_residency": "Manual `gpuArray` promotion is optional. If sampled data already lives on the GPU, RunMat preserves real-valued outputs as gpuArrays by re-uploading the trapezoidal result after the host fallback path.",
+    "gpu_behavior": [
+        "RunMat does not yet expose a native provider hook for `trapz`. When the input is a gpuArray, the runtime gathers the data to host memory, performs the trapezoidal integration with MATLAB-compatible dimension and spacing rules, and re-uploads real-valued outputs so downstream GPU work stays resident."
+    ],
+    "key": "trapz",
+    "slug": "trapz",
+    "categoryPath": [
+        "math",
+        "reduction"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=trapz.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trapz.js","sourceRoot":"","sources":["../../../src/generated/builtins/trapz.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE;QACV,OAAO;QACP,yBAAyB;QACzB,uBAAuB;QACvB,sBAAsB;QACtB,KAAK;KACN;IACD,SAAS,EAAE,oDAAoD;IAC/D,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,sJAAsJ;KAChK;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,yCAAyC;KAClD;IACD,aAAa,EAAE,2MAA2M;IAC1N,WAAW,EAAE;QACX,2DAA2D;QAC3D,wJAAwJ;QACxJ,qKAAqK;QACrK,qKAAqK;QACrK,mHAAmH;KACpH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yDAAyD;YACxE,OAAO,EAAE,iDAAiD;YAC1D,QAAQ,EAAE,UAAU;SACrB;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,4BAA4B;YACrC,QAAQ,EAAE,OAAO;SAClB;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,sCAAsC;YAC/C,QAAQ,EAAE,qBAAqB;SAChC;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,2DAA2D;YACpE,QAAQ,EAAE,YAAY;SACvB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,iDAAiD;SAC5D;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,sHAAsH;SACjI;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,8DAA8D;SACzE;QACD;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,iGAAiG;SAC5G;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,uLAAuL;SAClM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;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;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,eAAe,EAAE,2MAA2M;IAC5N,cAAc,EAAE;QACd,8SAA8S;KAC/S;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,cAAc,EAAE;QACd,MAAM;QACN,WAAW;KACZ;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/view.js

@@ -38,6 +38,20 @@ const builtinDoc = {
             "output": "% Returns a 1x2 vector [60 20]"
         }
     ],
+    "faqs": [
+        {
+            "question": "What do azimuth and elevation mean in view(az, el)?",
+            "answer": "Azimuth is the horizontal rotation around the z-axis (0° looks along the y-axis toward the origin). Elevation is the angle above the x-y plane (0° is level, 90° is directly overhead). `view(45, 30)` gives the classic isometric-ish perspective for 3-D surfaces."
+        },
+        {
+            "question": "How do I reset to the default 2-D or 3-D view?",
+            "answer": "`view(2)` sets the camera to top-down (azimuth 0, elevation 90) — useful for looking at a surface as a heatmap. `view(3)` restores the default 3-D camera at `[-37.5, 30]`, which is the standard MATLAB 3-D preset."
+        },
+        {
+            "question": "Can I set different view angles per subplot?",
+            "answer": "Yes. View state is subplot-local. Pass the axes handle explicitly to target a specific panel.\n\n```matlab\nax1 = subplot(1, 2, 1); surf(X, Y, Z); view(ax1, 0, 90);\nax2 = subplot(1, 2, 2); surf(X, Y, Z); view(ax2, 45, 30);\n```"
+        }
+    ],
     "links": [
         {
             "label": "plot3",
@@ -62,6 +76,22 @@ const builtinDoc = {
         {
             "label": "set",
             "url": "./set"
+        },
+        {
+            "label": "Choosing the right plot type",
+            "url": "/docs/plotting/choosing-the-right-plot-type"
+        },
+        {
+            "label": "Styling plots and axes",
+            "url": "/docs/plotting/styling-plots-and-axes"
+        },
+        {
+            "label": "Plot replay and export",
+            "url": "/docs/plotting/plot-replay-and-export"
+        },
+        {
+            "label": "Complete plotting guide",
+            "url": "/blog/matlab-plotting-guide"
         }
     ],
     "source": {

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

@@ -1 +1 @@
-{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/generated/builtins/view.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,YAAY;QACZ,mBAAmB;QACnB,aAAa;QACb,iBAAiB;KAClB;IACD,SAAS,EAAE,qHAAqH;IAChI,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,iCAAiC;KAC1C;IACD,aAAa,EAAE,mUAAmU;IAClV,WAAW,EAAE;QACX,oEAAoE;QACpE,2GAA2G;QAC3G,4FAA4F;QAC5F,wFAAwF;QACxF,qIAAqI;KACtI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,oHAAoH;SAC9H;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,yHAAyH;SACnI;QACD;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,0GAA0G;YACnH,QAAQ,EAAE,gCAAgC;SAC3C;KACF;IACD,OAAO,EAAE;QACP;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,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/generated/builtins/view.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,YAAY;QACZ,mBAAmB;QACnB,aAAa;QACb,iBAAiB;KAClB;IACD,SAAS,EAAE,qHAAqH;IAChI,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,iCAAiC;KAC1C;IACD,aAAa,EAAE,mUAAmU;IAClV,WAAW,EAAE;QACX,oEAAoE;QACpE,2GAA2G;QAC3G,4FAA4F;QAC5F,wFAAwF;QACxF,qIAAqI;KACtI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,oHAAoH;SAC9H;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,yHAAyH;SACnI;QACD;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,0GAA0G;YACnH,QAAQ,EAAE,gCAAgC;SAC3C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qDAAqD;YACjE,QAAQ,EAAE,sQAAsQ;SACjR;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,sNAAsN;SACjO;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,sOAAsO;SACjP;KACF;IACD,OAAO,EAAE;QACP;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,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;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,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/zlabel.js

@@ -36,6 +36,20 @@ const builtinDoc = {
             "input": "[X, Y] = meshgrid(linspace(-3, 3, 30), linspace(-3, 3, 30));\nZ = sin(X) .* cos(Y);\nsubplot(1, 2, 1);\nsurf(X, Y, Z);\nax = subplot(1, 2, 2);\nplot3(cos(0:0.1:5), sin(0:0.1:5), 0:0.1:5);\nzlabel(ax, 'Trajectory Height');"
         }
     ],
+    "faqs": [
+        {
+            "question": "When do I need zlabel vs just xlabel/ylabel?",
+            "answer": "`zlabel` only applies to 3-D axes — `surf`, `mesh`, `plot3`, `scatter3`, etc. For 2-D plots, the z-axis doesn't exist, so `zlabel` has no effect. If you're plotting in 3-D, always label all three axes so readers can orient themselves."
+        },
+        {
+            "question": "Can I use LaTeX formatting in zlabel?",
+            "answer": "You can use LaTeX-style inline math in the label string with standard TeX markup. Subscripts, superscripts, and Greek letters work in label text.\n\n```matlab\nzlabel('Temperature (\\circC)');\nzlabel('\\sigma_{z} (MPa)');\n```"
+        },
+        {
+            "question": "How do I style the z-axis label after creating it?",
+            "answer": "`zlabel` returns a text handle that works with `get` and `set`. You can change font weight, size, color, and other text properties through that handle.\n\n```matlab\nh = zlabel('Elevation (m)');\nset(h, 'FontWeight', 'bold', 'FontSize', 14);\n```"
+        }
+    ],
     "links": [
         {
             "label": "view",
@@ -56,6 +70,22 @@ const builtinDoc = {
         {
             "label": "set",
             "url": "./set"
+        },
+        {
+            "label": "Choosing the right plot type",
+            "url": "/docs/plotting/choosing-the-right-plot-type"
+        },
+        {
+            "label": "Styling plots and axes",
+            "url": "/docs/plotting/styling-plots-and-axes"
+        },
+        {
+            "label": "Plot replay and export",
+            "url": "/docs/plotting/plot-replay-and-export"
+        },
+        {
+            "label": "Complete plotting guide",
+            "url": "/blog/matlab-plotting-guide"
         }
     ],
     "source": {

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

@@ -1 +1 @@
-{"version":3,"file":"zlabel.js","sourceRoot":"","sources":["../../../src/generated/builtins/zlabel.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,cAAc;QACd,gBAAgB;QAChB,eAAe;QACf,uBAAuB;KACxB;IACD,SAAS,EAAE,2EAA2E;IACtF,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,mCAAmC;KAC5C;IACD,aAAa,EAAE,uSAAuS;IACtT,WAAW,EAAE;QACX,8FAA8F;QAC9F,4HAA4H;QAC5H,yIAAyI;QACzI,sFAAsF;KACvF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,wHAAwH;SAClI;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,wJAAwJ;SAClK;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,+NAA+N;SACzO;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"zlabel.js","sourceRoot":"","sources":["../../../src/generated/builtins/zlabel.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,cAAc;QACd,gBAAgB;QAChB,eAAe;QACf,uBAAuB;KACxB;IACD,SAAS,EAAE,2EAA2E;IACtF,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,mCAAmC;KAC5C;IACD,aAAa,EAAE,uSAAuS;IACtT,WAAW,EAAE;QACX,8FAA8F;QAC9F,4HAA4H;QAC5H,yIAAyI;QACzI,sFAAsF;KACvF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,wHAAwH;SAClI;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,wJAAwJ;SAClK;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,+NAA+N;SACzO;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,4OAA4O;SACvP;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,qOAAqO;SAChP;QACD;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,wPAAwP;SACnQ;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;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,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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