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

package/dist/generated/builtins/rmmissing.js

@@ -0,0 +1,68 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "rmmissing",
+    "category": "missing",
+    "keywords": [
+        "rmmissing",
+        "missing",
+        "NaN",
+        "string",
+        "table"
+    ],
+    "summary": "Remove missing elements, rows, or columns.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered before removal."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::missing::tests",
+        "integration": "crates/runmat-vm/tests/missing_values.rs"
+    },
+    "description": "`rmmissing(A)` removes entries containing missing values. For matrices and tables it removes rows by default; passing dimension `2` removes columns.",
+    "behaviors": [
+        "Vectors remove individual missing elements while preserving row or column orientation.",
+        "Matrices remove rows by default and columns when `dim` is `2` or the option is `\"columns\"`.",
+        "Tables remove rows with any missing variable entry by default, preserving variable names and row names.",
+        "Two-output calls return the result and a logical mask indicating removed rows, columns, or vector elements."
+    ],
+    "examples": [
+        {
+            "description": "Remove missing columns",
+            "input": "B = rmmissing([1 NaN 3; 4 5 6], 2)",
+            "output": "B = [1 3; 4 6]"
+        }
+    ],
+    "links": [
+        {
+            "label": "ismissing",
+            "url": "./ismissing"
+        },
+        {
+            "label": "fillmissing",
+            "url": "./fillmissing"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/missing/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/missing/mod.rs"
+    },
+    "key": "rmmissing",
+    "slug": "rmmissing",
+    "aliases": [],
+    "categoryPath": [
+        "missing"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=rmmissing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rmmissing.js","sourceRoot":"","sources":["../../../src/generated/builtins/rmmissing.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,WAAW;QACX,SAAS;QACT,KAAK;QACL,QAAQ;QACR,OAAO;KACR;IACD,SAAS,EAAE,4CAA4C;IACvD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yCAAyC;KACnD;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,0BAA0B;QAClC,aAAa,EAAE,0CAA0C;KAC1D;IACD,aAAa,EAAE,sJAAsJ;IACrK,WAAW,EAAE;QACX,wFAAwF;QACxF,+FAA+F;QAC/F,yGAAyG;QACzG,6GAA6G;KAC9G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,oCAAoC;YAC7C,QAAQ,EAAE,gBAAgB;SAC3B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qDAAqD;QAC9D,KAAK,EAAE,kGAAkG;KAC1G;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/rms.js

@@ -0,0 +1,75 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "rms",
+    "category": "math/reduction",
+    "keywords": [
+        "rms",
+        "root mean square",
+        "statistics",
+        "signal"
+    ],
+    "summary": "Compute root mean square values.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host for compatibility until provider reduction hooks exist."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::summary::descriptive::tests",
+        "integration": null
+    },
+    "description": "`rms(X)` computes `sqrt(mean(abs(X).^2))` along the first non-singleton dimension. Dimension, vector-dimension, `\"all\"`, `\"includenan\"`, `\"omitnan\"`, `\"includemissing\"`, and `\"omitmissing\"` forms are supported.",
+    "behaviors": [
+        "NaNs are included by default.",
+        "`\"omitnan\"` skips NaNs in each slice; empty slices return `NaN`.",
+        "Logical and integer inputs are promoted to double precision before reduction.",
+        "Complex inputs are reduced using magnitude."
+    ],
+    "examples": [
+        {
+            "description": "Root mean square of a vector",
+            "input": "r = rms([1 2 4], \"all\")"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Is rms the same as norm divided by sqrt(n)?",
+            "answer": "For a vector without omitted values, yes: `rms(x)` equals `norm(x)/sqrt(numel(x))`."
+        }
+    ],
+    "links": [
+        {
+            "label": "rmse",
+            "url": "./rmse"
+        },
+        {
+            "label": "mean",
+            "url": "./mean"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/summary/descriptive.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/summary/descriptive.rs"
+    },
+    "key": "rms",
+    "slug": "rms",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "reduction"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=rms.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rms.js","sourceRoot":"","sources":["../../../src/generated/builtins/rms.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE;QACV,KAAK;QACL,kBAAkB;QAClB,YAAY;QACZ,QAAQ;KACT;IACD,SAAS,EAAE,kCAAkC;IAC7C,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yFAAyF;KACnG;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,8CAA8C;QACtD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,8NAA8N;IAC7O,WAAW,EAAE;QACX,+BAA+B;QAC/B,oEAAoE;QACpE,+EAA+E;QAC/E,6CAA6C;KAC9C;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,2BAA2B;SACrC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,qFAAqF;SAChG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,WAAW;KACZ;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/rmse.js

@@ -0,0 +1,81 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "rmse",
+    "category": "stats/summary",
+    "keywords": [
+        "rmse",
+        "root mean squared error",
+        "error",
+        "statistics"
+    ],
+    "summary": "Compute root mean squared error between two arrays.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "elementwise",
+        "notes": "GPU inputs are gathered to host for compatibility until provider reduction hooks exist."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::summary::descriptive::tests",
+        "integration": null
+    },
+    "description": "`rmse(F,A)` computes `sqrt(mean(abs(F-A).^2))`. MATLAB-compatible implicit expansion, dimension selection, `\"all\"`, missing-value flags, and `\"Weights\",W` for single-dimension reductions are supported.",
+    "behaviors": [
+        "`F` and `A` may be scalars or compatible-size numeric or complex arrays.",
+        "NaNs are included by default.",
+        "`\"omitnan\"` and `\"omitmissing\"` skip NaN residuals and NaN weights in each slice.",
+        "`\"Weights\",W` accepts scalar weights, full-size weights, or a vector matching the reduction dimension.",
+        "Weights are rejected with `\"all\"` or vector-dimension reductions.",
+        "Weights must be nonnegative; zero total weight returns `NaN`."
+    ],
+    "examples": [
+        {
+            "description": "Root mean squared error",
+            "input": "e = rmse(predicted, actual)"
+        },
+        {
+            "description": "Weighted column-wise error",
+            "input": "e = rmse(F, A, 1, \"Weights\", W)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How are weights normalized?",
+            "answer": "Weighted RMSE uses `sqrt(sum(W.*E.^2)/sum(W))` over each reduction slice."
+        }
+    ],
+    "links": [
+        {
+            "label": "rms",
+            "url": "./rms"
+        },
+        {
+            "label": "mean",
+            "url": "./mean"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/summary/descriptive.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/summary/descriptive.rs"
+    },
+    "key": "rmse",
+    "slug": "rmse",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "summary"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=rmse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rmse.js","sourceRoot":"","sources":["../../../src/generated/builtins/rmse.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,MAAM;QACN,yBAAyB;QACzB,OAAO;QACP,YAAY;KACb;IACD,SAAS,EAAE,qDAAqD;IAChE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,aAAa;QAC7B,OAAO,EAAE,yFAAyF;KACnG;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,8CAA8C;QACtD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,+MAA+M;IAC9N,WAAW,EAAE;QACX,0EAA0E;QAC1E,+BAA+B;QAC/B,uFAAuF;QACvF,0GAA0G;QAC1G,qEAAqE;QACrE,+DAA+D;KAChE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,6BAA6B;SACvC;QACD;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,mCAAmC;SAC7C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6BAA6B;YACzC,QAAQ,EAAE,2EAA2E;SACtF;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/round.js

@@ -19,7 +19,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "matlab",
-        "notes": "Falls back to the host implementation when rounding to digits or significant figures if the active provider lacks unary_round."
+        "notes": "Uses unary_round for plain rounding and round_digits for decimal-place or significant-digit rounding when the active provider implements those hooks; otherwise falls back to host semantics."
     },
     "fusion": {
         "elementwise": true,
@@ -65,7 +65,7 @@ const builtinDoc = {
         },
         {
             "description": "Rounding GPU tensors and gathering the results",
-            "input": "G = gpuArray(linspace(-2.5, 2.5, 6));\nrounded = round(G);\nhostValues = gather(rounded)",
+            "input": "G = gpuArray(linspace(-2.5, 2.5, 6));\nrounded = round(G, 2);\nhostValues = gather(rounded)",
             "output": "hostValues = [-3 -2 -1 1 2 3]"
         }
     ],
@@ -92,7 +92,7 @@ const builtinDoc = {
         },
         {
             "question": "Will rounding stay on the GPU?",
-            "answer": "`round(X)` stays on the GPU when the provider implements `unary_round`. Rounding with digit arguments currently gathers to the host; providers can override this by adding specialised kernels."
+            "answer": "`round(X)` stays on the GPU when the provider implements `unary_round`. `round(X, N)` and `round(X, N, 'significant')` also stay resident when the provider implements the `round_digits` hook; otherwise RunMat gathers and uses the host implementation."
         },
         {
             "question": "Can I round logical or character arrays?",
@@ -153,9 +153,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/math/rounding/round.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/rounding/round.rs"
     },
-    "gpu_residency": "You usually do **not** need to call `gpuArray` manually. RunMat's planner keeps tensors on the GPU when the provider exposes the required kernels and it is profitable to do so. `round` takes advantage of this mechanism for the plain `round(X)` form. When you specify digits or the `'significant'` option, RunMat currently gathers data to the host to match MATLAB exactly. Future providers can extend `unary_round` or add digit-aware kernels to keep those workloads on the device.",
+    "gpu_residency": "You usually do **not** need to call `gpuArray` manually. RunMat's planner keeps tensors on the GPU when the provider exposes the required kernels and it is profitable to do so. `round` takes advantage of this mechanism for the plain `round(X)` form through `unary_round` and for digit-aware forms through `round_digits`. If a provider lacks the relevant hook, RunMat gathers to the host to preserve MATLAB semantics.",
     "gpu_behavior": [
-        "When a tensor already resides on the GPU, RunMat checks whether the active acceleration provider implements a specialised `unary_round` kernel. If available, `round(X)` executes entirely on the device. Advanced modes (`round(X, N)` and `round(X, N, 'significant')`) currently gather tensors to the host before rounding to keep semantics aligned with MATLAB. Providers that add digit-aware kernels can extend this path in the future."
+        "When a tensor already resides on the GPU, RunMat checks whether the active acceleration provider implements `unary_round` for `round(X)` or `round_digits` for `round(X, N)` and `round(X, N, 'significant')`. If available, the operation executes entirely on the device; otherwise RunMat gathers tensors to the host before rounding to keep semantics aligned with MATLAB."
     ],
     "syntax": {
         "example": {

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

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

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

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

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

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

package/dist/generated/builtins/rowfilter.js

@@ -0,0 +1,62 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "rowfilter",
+    "category": "table",
+    "keywords": [
+        "rowfilter",
+        "table",
+        "rows",
+        "filter"
+    ],
+    "summary": "Create a table row filter selector object.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Filter descriptors are host metadata."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::table::tests",
+        "integration": "crates/runmat-vm/tests/tables_timetables.rs"
+    },
+    "description": "`rowfilter(vars, predicate)` creates a selector object with `Variables` and `Predicate` properties for table row filtering workflows.",
+    "behaviors": [
+        "The selector can be used as a table or timetable row subscript.",
+        "Logical predicate arrays are applied directly.",
+        "Named scalar predicates such as `\"@gt0\"`, `\"@ge0\"`, `\"@lt0\"`, and `\"nonmissing\"` are evaluated against the selected variables."
+    ],
+    "examples": [
+        {
+            "description": "Filter rows",
+            "input": "T(rowfilter({'A'}, '@gt0'), :)",
+            "output": "Rows where variable A is positive"
+        }
+    ],
+    "links": [
+        {
+            "label": "vartype",
+            "url": "./vartype"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/table/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/table/mod.rs"
+    },
+    "key": "rowfilter",
+    "slug": "rowfilter",
+    "aliases": [],
+    "categoryPath": [
+        "table"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=rowfilter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowfilter.js","sourceRoot":"","sources":["../../../src/generated/builtins/rowfilter.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,WAAW;QACX,OAAO;QACP,MAAM;QACN,QAAQ;KACT;IACD,SAAS,EAAE,4CAA4C;IACvD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,uCAAuC;KACjD;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,wBAAwB;QAChC,aAAa,EAAE,6CAA6C;KAC7D;IACD,aAAa,EAAE,uIAAuI;IACtJ,WAAW,EAAE;QACX,iEAAiE;QACjE,gDAAgD;QAChD,wIAAwI;KACzI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,aAAa;YAC5B,OAAO,EAAE,gCAAgC;YACzC,QAAQ,EAAE,mCAAmC;SAC9C;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mDAAmD;QAC5D,KAAK,EAAE,gGAAgG;KACxG;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/run.js

@@ -37,9 +37,10 @@ const builtinDoc = {
             "run_missing_file_and_output_errors_are_catchable"
         ]
     },
-    "description": "`run` locates a `.m` script by file name, relative path, absolute path, or active MATLAB search path entry, then executes that script in the caller workspace. Variables assigned by the script are visible to following statements in the caller.",
+    "description": "`run` locates a `.p` or `.m` script by file name, relative path, absolute path, or active MATLAB search path entry, then executes that script in the caller workspace. Variables assigned by the script are visible to following statements in the caller.",
     "behaviors": [
-        "`run('script')` resolves `script.m` when no extension is supplied. Bare `.m` filenames also search the active MATLAB path. `run('folder/script.m')` executes the file at that path.",
+        "`run('script')` resolves `script.p` before `script.m` when no extension is supplied. Bare `.p` and `.m` filenames also search the active MATLAB path. `run('folder/script.m')` executes the file at that path.",
+        "RunMat-generated `.p` files are decoded before parsing. Proprietary or non-RunMat `.p` files report `RunMat:pcode:InvalidPcode`.",
         "Command syntax is supported: `run script_name` is equivalent to `run('script_name')`.",
         "The target file is executed as a script, not as a function. Assignments mutate the caller workspace and local functions in the script remain available to that script.",
         "`mfilename` inside the executed script reports the executed file name and full path, matching the script source context.",
@@ -72,7 +73,7 @@ const builtinDoc = {
         },
         {
             "question": "Where does `run` search?",
-            "answer": "RunMat first resolves the provided file or relative path, then searches the active MATLAB path. It appends `.m` when the supplied name has no extension, and a bare filename that already ends in `.m` is also searched on the active path."
+            "answer": "RunMat first resolves the provided file or relative path, then searches the active MATLAB path. It checks `.p` before `.m` when the supplied name has no extension, and a sibling `.p` takes precedence when the resolved source path names `.m`."
         },
         {
             "question": "What happens if the script creates variables?",

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

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/generated/builtins/run.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,KAAK;QACL,QAAQ;QACR,eAAe;QACf,WAAW;QACX,MAAM;KACP;IACD,SAAS,EAAE,uDAAuD;IAClE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mGAAmG;KAC7G;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,mCAAmC;QAC3C,aAAa,EAAE;YACb,+CAA+C;YAC/C,uDAAuD;YACvD,+CAA+C;YAC/C,8CAA8C;YAC9C,oDAAoD;YACpD,qCAAqC;YACrC,kDAAkD;SACnD;KACF;IACD,aAAa,EAAE,oPAAoP;IACnQ,WAAW,EAAE;QACX,qLAAqL;QACrL,uFAAuF;QACvF,wKAAwK;QACxK,0HAA0H;QAC1H,0GAA0G;QAC1G,iJAAiJ;QACjJ,mVAAmV;KACpV;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,yDAAyD;SACnE;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,yDAAyD;SACnE;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,6EAA6E;SACvF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,0FAA0F;SACrG;QACD;YACE,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,mGAAmG;SAC9G;QACD;YACE,UAAU,EAAE,0BAA0B;YACtC,QAAQ,EAAE,6OAA6O;SACxP;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,+NAA+N;SAC1O;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,yLAAyL;SACpM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,eAAe,EAAE,qIAAqI;IACtJ,cAAc,EAAE;QACd,6MAA6M;KAC9M;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/generated/builtins/run.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,KAAK;QACL,QAAQ;QACR,eAAe;QACf,WAAW;QACX,MAAM;KACP;IACD,SAAS,EAAE,uDAAuD;IAClE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mGAAmG;KAC7G;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,mCAAmC;QAC3C,aAAa,EAAE;YACb,+CAA+C;YAC/C,uDAAuD;YACvD,+CAA+C;YAC/C,8CAA8C;YAC9C,oDAAoD;YACpD,qCAAqC;YACrC,kDAAkD;SACnD;KACF;IACD,aAAa,EAAE,4PAA4P;IAC3Q,WAAW,EAAE;QACX,gNAAgN;QAChN,kIAAkI;QAClI,uFAAuF;QACvF,wKAAwK;QACxK,0HAA0H;QAC1H,0GAA0G;QAC1G,iJAAiJ;QACjJ,mVAAmV;KACpV;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,yDAAyD;SACnE;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,yDAAyD;SACnE;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,6EAA6E;SACvF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,0FAA0F;SACrG;QACD;YACE,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,mGAAmG;SAC9G;QACD;YACE,UAAU,EAAE,0BAA0B;YACtC,QAAQ,EAAE,mPAAmP;SAC9P;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,+NAA+N;SAC1O;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,yLAAyL;SACpM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,eAAe,EAAE,qIAAqI;IACtJ,cAAc,EAAE;QACd,6MAA6M;KAC9M;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/runtests.js

@@ -0,0 +1,123 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "runtests",
+    "category": "diagnostics",
+    "keywords": [
+        "runtests",
+        "unit testing",
+        "test",
+        "developer tools",
+        "matlab.unittest"
+    ],
+    "summary": "Discover and run MATLAB-style test files through the RunMat VM.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`runtests` is a host-side discovery and VM execution boundary. Test bodies may call GPU-capable builtins normally, but `runtests` itself has no provider kernel."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": null,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::diagnostics::runtests::tests",
+        "integration": [
+            "runtests_runs_script_test_file_and_restores_workspace",
+            "runtests_records_failing_script_test_as_result",
+            "runtests_discovers_subfolder_tests_when_requested",
+            "runtests_no_arg_discovers_current_folder_without_recursing",
+            "runtests_basefolder_constrains_relative_target_resolution",
+            "runtests_accepts_useparallel_false",
+            "runtests_runs_zero_argument_function_tests",
+            "runtests_rejects_parallel_execution_option"
+        ]
+    },
+    "description": "`runtests` discovers `.m` files that look like MATLAB test files, executes each test through the normal RunMat compiler/VM path, and returns RunMat `matlab.unittest.TestResult`-compatible result objects. Until RunMat has first-class MATLAB object arrays, zero or multiple results are represented as a 1-by-N cell row of result objects rather than a MATLAB object array.",
+    "behaviors": [
+        "`results = runtests` discovers tests in the current folder.",
+        "`results = runtests(target)` accepts a test file, folder, function name, string array, or cell array of string targets. Bare names are resolved like MATLAB `.m` files on the active search path.",
+        "`BaseFolder` constrains relative explicit targets to one or more base folders. When no explicit target is supplied, the base folders act as discovery roots.",
+        "Folder discovery includes files whose stem starts with `test` or ends with `Test`. `IncludeSubfolders` recursively includes subfolders.",
+        "Script-style tests run as isolated test workspaces. Variables assigned by a test file do not leak into the caller workspace.",
+        "Function-style files with local zero-argument `test*` or `*Test` functions are split into one test case per function by running the file source plus that function call. Full `functiontests(localfunctions)`, `testCase` arguments, setup/teardown fixtures, class-based tests, and shared fixture semantics require broader `matlab.unittest` infrastructure and are not implemented by this slice.",
+        "Each result object includes `Name`, `TestFile`, `Passed`, `Failed`, `Incomplete`, `Duration`, and `Details` properties. A single result is returned as a scalar object; zero or multiple results are returned as a cell row of result objects.",
+        "A failing test is captured as a failed result rather than as a `runtests` call failure. Discovery, invalid option, and unsupported infrastructure errors still surface as diagnostics.",
+        "`Name` and `ProcedureName` filters currently keep cases whose generated test name contains the supplied text. They do not yet implement the full MATLAB selector model. `OutputDetail` and `LoggingLevel` are accepted for compatibility but do not affect execution output yet.",
+        "`UseParallel=false` is accepted. `UseParallel=true`, coverage collection, and tag metadata filtering are explicitly rejected because they require separate parallel or `matlab.unittest` infrastructure."
+    ],
+    "examples": [
+        {
+            "description": "Run a single script test file",
+            "input": "results = runtests('testSmoke.m')"
+        },
+        {
+            "description": "Run tests below a folder",
+            "input": "results = runtests('tests', 'IncludeSubfolders', true)"
+        },
+        {
+            "description": "Filter discovered cases by name",
+            "input": "results = runtests('tests', 'IncludeSubfolders', true, 'Name', 'Solver')"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `runtests` support Parallel Computing Toolbox execution?",
+            "answer": "No. `UseParallel=true` is rejected and tracked with the separate parallel/GPU effort. `UseParallel=false` is accepted."
+        },
+        {
+            "question": "Does `runtests` support coverage?",
+            "answer": "No. Coverage collection is explicitly rejected because RunMat does not yet have the source instrumentation layer required for MATLAB-compatible coverage reports."
+        },
+        {
+            "question": "Does `runtests` return MATLAB object arrays?",
+            "answer": "Not yet. A single result is a `matlab.unittest.TestResult` object, while zero or multiple results are returned as a cell row until RunMat has first-class MATLAB object-array support."
+        },
+        {
+            "question": "Does `runtests` support the full `matlab.unittest` framework?",
+            "answer": "No. This slice covers script tests, simple zero-argument function tests, discovery, filtering, isolation, and result objects. Full `functiontests(localfunctions)`, `testCase` fixtures, setup/teardown, class-based tests, tags, and coverage need additional shared testing/object infrastructure."
+        },
+        {
+            "question": "Do test variables leak into the caller workspace?",
+            "answer": "No. RunMat snapshots the caller workspace, runs each test in a temporary workspace, and restores the caller workspace before returning result objects."
+        },
+        {
+            "question": "Can tests use GPU arrays?",
+            "answer": "Yes, when the test body calls GPU-capable builtins. `runtests` itself is not a numeric operation and does not own GPU dispatch."
+        }
+    ],
+    "links": [
+        {
+            "label": "assert",
+            "url": "./assert"
+        },
+        {
+            "label": "run",
+            "url": "./run"
+        },
+        {
+            "label": "evalc",
+            "url": "./evalc"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/diagnostics/runtests.rs` and `crates/runmat-vm/src/call/builtins.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/diagnostics/runtests.rs"
+    },
+    "gpu_behavior": [
+        "`runtests` is a host-side filesystem discovery and VM execution boundary. It does not create GPU kernels and does not participate in fusion. Individual test bodies may exercise GPU-capable operations normally."
+    ],
+    "key": "runtests",
+    "slug": "runtests",
+    "aliases": [],
+    "categoryPath": [
+        "diagnostics"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=runtests.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtests.js","sourceRoot":"","sources":["../../../src/generated/builtins/runtests.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,UAAU;QACV,cAAc;QACd,MAAM;QACN,iBAAiB;QACjB,iBAAiB;KAClB;IACD,SAAS,EAAE,iEAAiE;IAC5E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,kKAAkK;KAC5K;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,MAAM,EAAE,wCAAwC;QAChD,aAAa,EAAE;YACb,uDAAuD;YACvD,gDAAgD;YAChD,mDAAmD;YACnD,4DAA4D;YAC5D,2DAA2D;YAC3D,oCAAoC;YACpC,4CAA4C;YAC5C,4CAA4C;SAC7C;KACF;IACD,aAAa,EAAE,mXAAmX;IAClY,WAAW,EAAE;QACX,6DAA6D;QAC7D,mMAAmM;QACnM,8JAA8J;QAC9J,yIAAyI;QACzI,8HAA8H;QAC9H,uYAAuY;QACvY,gPAAgP;QAChP,wLAAwL;QACxL,kRAAkR;QAClR,0MAA0M;KAC3M;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,mCAAmC;SAC7C;QACD;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,wDAAwD;SAClE;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,0EAA0E;SACpF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+DAA+D;YAC3E,QAAQ,EAAE,wHAAwH;SACnI;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,mKAAmK;SAC9K;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,wLAAwL;SACnM;QACD;YACE,UAAU,EAAE,+DAA+D;YAC3E,QAAQ,EAAE,sSAAsS;SACjT;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,wJAAwJ;SACnK;QACD;YACE,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,iIAAiI;SAC5I;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,0GAA0G;QACnH,KAAK,EAAE,2GAA2G;KACnH;IACD,cAAc,EAAE;QACd,mNAAmN;KACpN;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,aAAa;KACd;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/save.js

@@ -41,7 +41,7 @@ const builtinDoc = {
         "`save filename -regexp '^foo' 'bar$'` saves every variable whose name matches any of the supplied regular expressions.",
         "Existing files are overwritten unless `-append` is specified. With `-append`, RunMat reads the existing supported MAT variables, merges in the newly selected variables, and rewrites the file so newer variables replace older variables with the same name.",
         "Numeric/text format flags outside the MAT-file path (for example `-ascii`, `-double`, `-v6`, `-v7.3`) are not supported yet and report descriptive option errors.",
-        "Unsupported types (function handles, objects, opaque graphics handles) raise descriptive errors. Numeric, logical, character, string, cell, scalar struct, and real sparse data are stored using MATLAB Level-5 MAT-file layout.",
+        "Function handles and opaque graphics handles raise descriptive errors. Numeric, logical, character, string, cell, scalar struct, real sparse data, and RunMat objects are stored using MATLAB Level-5 MAT-file layout. Objects are written through `saveobj` when registered and otherwise through an internal scalar-struct object envelope.",
         "`save` returns `0` so scripts can treat it as a statement, matching MATLAB's void behaviour."
     ],
     "examples": [
@@ -93,7 +93,7 @@ const builtinDoc = {
         },
         {
             "question": "Are objects or function handles saved?",
-            "answer": "No. RunMat matches MATLAB by raising an error when unsupported types are encountered."
+            "answer": "Objects are supported through RunMat's object serialization envelope and registered `saveobj` hooks. Function handles remain unsupported and raise an error."
         },
         {
             "question": "Does `save` return a value?",
@@ -128,6 +128,10 @@ const builtinDoc = {
         {
             "label": "load",
             "url": "./load"
+        },
+        {
+            "label": "saveobj",
+            "url": "./saveobj"
         }
     ],
     "source": {

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

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