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

package/dist/generated/builtins/daspect.js

@@ -0,0 +1,75 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "daspect",
+    "keywords": [
+        "daspect",
+        "data aspect ratio",
+        "plotting",
+        "axes"
+    ],
+    "category": "plotting",
+    "summary": "Query or set axes data aspect ratio.",
+    "status": "implemented",
+    "backend": {
+        "runtime": "runmat-runtime",
+        "acceleration": "metadata-only",
+        "notes": "`daspect` reads and writes axes metadata. Manual data aspect ratios are applied by the plotting display-bounds and camera-fit paths; numeric plot buffers are not gathered or transformed."
+    },
+    "tests": {
+        "unit": "builtins::plotting::daspect::tests"
+    },
+    "description": "`daspect` controls the data aspect ratio for the current or specified axes. RunMat supports ratio query, positive three-element ratio assignment, mode query, `auto`/`manual` mode assignment, and the corresponding `DataAspectRatio` and `DataAspectRatioMode` axes properties.",
+    "signatures": [
+        "ratio = daspect()",
+        "daspect([dx dy dz])",
+        "mode = daspect('mode')",
+        "daspect('auto')",
+        "daspect('manual')",
+        "ratio = daspect(ax)",
+        "daspect(ax, ratioOrMode)"
+    ],
+    "examples": [
+        {
+            "input": "plot(0:10, sin(0:10));\ndaspect([1 2 1]);\nget(gca, 'DataAspectRatio')",
+            "output": "ans =\n     1     2     1"
+        },
+        {
+            "input": "ax = subplot(1,2,1);\nplot(ax, 1:4, [1 4 9 16]);\ndaspect(ax, [1 1 1]);\ndaspect(ax, 'mode')",
+            "output": "ans =\n    'manual'"
+        }
+    ],
+    "notes": [
+        "`daspect([dx dy dz])` sets `DataAspectRatioMode` to `manual`.",
+        "`daspect('auto')` and `set(gca,'DataAspectRatioMode','auto')` preserve the stored ratio but return display bounds to automatic aspect fitting.",
+        "RunMat applies manual X/Y data aspect ratios to 2-D display bounds and X/Y/Z data aspect ratios to 3-D camera-fit bounds."
+    ],
+    "related": [
+        {
+            "label": "axis",
+            "url": "./axis"
+        },
+        {
+            "label": "xscale",
+            "url": "./xscale"
+        },
+        {
+            "label": "yscale",
+            "url": "./yscale"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/daspect.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/daspect.rs"
+    },
+    "gpu_residency": "`daspect` is axes metadata only. It does not gather, upload, or mutate numeric GPU buffers; rendering applies the stored aspect metadata through the normal plot camera/bounds path.",
+    "limitations": [],
+    "key": "daspect",
+    "slug": "daspect",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=daspect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"daspect.js","sourceRoot":"","sources":["../../../src/generated/builtins/daspect.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE;QACV,SAAS;QACT,mBAAmB;QACnB,UAAU;QACV,MAAM;KACP;IACD,UAAU,EAAE,UAAU;IACtB,SAAS,EAAE,sCAAsC;IACjD,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE;QACT,SAAS,EAAE,gBAAgB;QAC3B,cAAc,EAAE,eAAe;QAC/B,OAAO,EAAE,4LAA4L;KACtM;IACD,OAAO,EAAE;QACP,MAAM,EAAE,oCAAoC;KAC7C;IACD,aAAa,EAAE,mRAAmR;IAClS,YAAY,EAAE;QACZ,mBAAmB;QACnB,qBAAqB;QACrB,wBAAwB;QACxB,iBAAiB;QACjB,mBAAmB;QACnB,qBAAqB;QACrB,0BAA0B;KAC3B;IACD,UAAU,EAAE;QACV;YACE,OAAO,EAAE,wEAAwE;YACjF,QAAQ,EAAE,2BAA2B;SACtC;QACD;YACE,OAAO,EAAE,8FAA8F;YACvG,QAAQ,EAAE,qBAAqB;SAChC;KACF;IACD,OAAO,EAAE;QACP,+DAA+D;QAC/D,gJAAgJ;QAChJ,2HAA2H;KAC5H;IACD,SAAS,EAAE;QACT;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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,sLAAsL;IACvM,aAAa,EAAE,EAAE;IACjB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

@@ -0,0 +1,100 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "dataTipTextRow",
+    "category": "plotting",
+    "keywords": [
+        "dataTipTextRow",
+        "data tip",
+        "datatip",
+        "data cursor",
+        "plotting",
+        "graphics"
+    ],
+    "summary": "Create a data-tip text row object for customizing plot data tips.",
+    "hero_image": null,
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`dataTipTextRow` constructs metadata. It stores the supplied value object as-is, including GPU-resident tensor handles, and does not gather numeric payloads."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::data_tip_text_row::tests",
+        "integration": "crates/runmat-vm/tests/plotting.rs"
+    },
+    "description": "`dataTipTextRow(label, value)` creates a MATLAB-compatible `matlab.graphics.datatip.DataTipTextRow` handle object with `Label`, `Value`, and `Format` properties. Use these rows with plot data-tip templates as RunMat's graphics template support expands.",
+    "behaviors": [
+        "`dataTipTextRow(label, value)` creates a handle-class row object and stores an empty `Format` property so the renderer or host can use its default formatting.",
+        "`dataTipTextRow(label, value, format)` stores the supplied display format string.",
+        "`label` and `format` accept character vectors, string scalars, and scalar string arrays.",
+        "`Value` is preserved without reinterpretation, so property names such as `'YData'`, numeric vectors, string values, function handles, and GPU-resident values remain available to downstream graphics code.",
+        "Returned rows support dot-property access and mutation for `Label`, `Value`, and `Format`; aliases refer to the same underlying handle object."
+    ],
+    "options": [
+        "`Label` is the displayed row label.",
+        "`Value` is the data source, value vector, expression result, or property name used by the row.",
+        "`Format` is an optional numeric, datetime, duration, or text display format."
+    ],
+    "examples": [
+        {
+            "description": "Create a row that reads from plotted Y data",
+            "input": "row = dataTipTextRow('Speed', 'YData', '%.2f');\nrow.Label",
+            "output": "ans =\n    \"Speed\""
+        },
+        {
+            "description": "Create a row from explicit values",
+            "input": "values = [10 20 30];\nrow = dataTipTextRow('Amplitude', values);\nrow.Format = '%.1f';",
+            "output": "% row is a DataTipTextRow handle object"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does dataTipTextRow render data tips by itself?",
+            "answer": "No. It creates the row object used by data-tip templates. Rendering and interactive data cursor behavior are handled by graphics hosts and future template integration."
+        },
+        {
+            "question": "Does it gather GPU data?",
+            "answer": "No. RunMat preserves the supplied `Value` property as metadata, including GPU tensor handles, so constructing a row does not force a host round trip."
+        }
+    ],
+    "links": [
+        {
+            "label": "line",
+            "url": "./line"
+        },
+        {
+            "label": "plot",
+            "url": "./plot"
+        },
+        {
+            "label": "scatter",
+            "url": "./scatter"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/data_tip_text_row.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/data_tip_text_row.rs"
+    },
+    "gpu_residency": "`dataTipTextRow` is metadata-only. It does not inspect, gather, or convert the supplied `Value` property, so GPU-resident values remain represented by their existing handles.",
+    "gpu_behavior": [
+        "Object construction terminates numeric fusion because the result is a graphics metadata object.",
+        "Supplying a GPU-resident value preserves the handle in the returned object's `Value` property."
+    ],
+    "key": "datatiptextrow",
+    "slug": "datatiptextrow",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=dataTipTextRow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataTipTextRow.js","sourceRoot":"","sources":["../../../src/generated/builtins/dataTipTextRow.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,gBAAgB;IACzB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,gBAAgB;QAChB,UAAU;QACV,SAAS;QACT,aAAa;QACb,UAAU;QACV,UAAU;KACX;IACD,SAAS,EAAE,mEAAmE;IAC9E,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,+JAA+J;KACzK;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,8CAA8C;QACtD,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,8PAA8P;IAC7Q,WAAW,EAAE;QACX,gKAAgK;QAChK,mFAAmF;QACnF,0FAA0F;QAC1F,6MAA6M;QAC7M,gJAAgJ;KACjJ;IACD,SAAS,EAAE;QACT,qCAAqC;QACrC,gGAAgG;QAChG,8EAA8E;KAC/E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,4DAA4D;YACrE,QAAQ,EAAE,sBAAsB;SACjC;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,wFAAwF;YACjG,QAAQ,EAAE,yCAAyC;SACpD;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,yKAAyK;SACpL;QACD;YACE,UAAU,EAAE,0BAA0B;YACtC,QAAQ,EAAE,uJAAuJ;SAClK;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wEAAwE;QACjF,KAAK,EAAE,qHAAqH;KAC7H;IACD,eAAe,EAAE,gLAAgL;IACjM,cAAc,EAAE;QACd,iGAAiG;QACjG,gGAAgG;KACjG;IACD,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/datacursormode.js

@@ -0,0 +1,83 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "datacursormode",
+    "category": "plotting",
+    "keywords": [
+        "datacursormode",
+        "data cursor",
+        "data tips",
+        "interactive plotting"
+    ],
+    "summary": "Control data cursor interaction mode for figures.",
+    "status": "done",
+    "version_added": "0.5.3",
+    "tests": {
+        "unit": "builtins::plotting::datacursormode::tests"
+    },
+    "description": "`datacursormode` toggles or configures MATLAB-compatible data cursor mode state. It returns a live data cursor manager object whose common properties can be read or updated through `get` and `set`.",
+    "syntax": [
+        "datacursormode",
+        "datacursormode(option)",
+        "datacursormode(fig, option)",
+        "dcm = datacursormode",
+        "dcm = datacursormode(fig)"
+    ],
+    "arguments": [
+        {
+            "name": "option",
+            "type": "'on' | 'off' | 'toggle'",
+            "description": "Data cursor mode command."
+        },
+        {
+            "name": "fig",
+            "type": "figure handle",
+            "description": "Target figure handle."
+        }
+    ],
+    "examples": [
+        {
+            "description": "Enable data cursor mode",
+            "input": "plot(1:10);\ndatacursormode on;",
+            "output": "% Data cursor mode is enabled"
+        },
+        {
+            "description": "Use the data cursor manager object",
+            "input": "dcm = datacursormode;\nset(dcm, 'DisplayStyle', 'window', 'SnapToDataVertex', 'off');\nget(dcm, 'DisplayStyle')",
+            "output": "ans = 'window'"
+        }
+    ],
+    "notes": [
+        "Statement-form `datacursormode()` toggles data cursor mode. Output-form `dcm = datacursormode()` returns a data cursor manager object.",
+        "The data cursor manager object supports `Enable`, `SnapToDataVertex`, `DisplayStyle`, `UpdateFcn`, and `FigureHandle` properties."
+    ],
+    "gpu_residency": "`datacursormode` mutates plotting interaction metadata only. It does not gather or copy GPU-resident plot data.",
+    "related": [
+        {
+            "label": "dataTipTextRow",
+            "url": "./dataTipTextRow"
+        },
+        {
+            "label": "get",
+            "url": "./get"
+        },
+        {
+            "label": "set",
+            "url": "./set"
+        }
+    ],
+    "implemented_in": [
+        {
+            "label": "crates/runmat-runtime/src/builtins/plotting/ops/datacursormode.rs",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/datacursormode.rs"
+        }
+    ],
+    "key": "datacursormode",
+    "slug": "datacursormode",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=datacursormode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datacursormode.js","sourceRoot":"","sources":["../../../src/generated/builtins/datacursormode.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,gBAAgB;IACzB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,gBAAgB;QAChB,aAAa;QACb,WAAW;QACX,sBAAsB;KACvB;IACD,SAAS,EAAE,mDAAmD;IAC9D,QAAQ,EAAE,MAAM;IAChB,eAAe,EAAE,OAAO;IACxB,OAAO,EAAE;QACP,MAAM,EAAE,2CAA2C;KACpD;IACD,aAAa,EAAE,uMAAuM;IACtN,QAAQ,EAAE;QACR,gBAAgB;QAChB,wBAAwB;QACxB,6BAA6B;QAC7B,sBAAsB;QACtB,2BAA2B;KAC5B;IACD,WAAW,EAAE;QACX;YACE,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,yBAAyB;YACjC,aAAa,EAAE,2BAA2B;SAC3C;QACD;YACE,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,eAAe;YACvB,aAAa,EAAE,uBAAuB;SACvC;KACF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,+BAA+B;SAC1C;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,iHAAiH;YAC1H,QAAQ,EAAE,gBAAgB;SAC3B;KACF;IACD,OAAO,EAAE;QACP,wIAAwI;QACxI,mIAAmI;KACpI;IACD,eAAe,EAAE,iHAAiH;IAClI,SAAS,EAAE;QACT;YACE,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,kBAAkB;SAC1B;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,gBAAgB,EAAE;QAChB;YACE,OAAO,EAAE,mEAAmE;YAC5E,KAAK,EAAE,kHAAkH;SAC1H;KACF;IACD,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/datasample.js

@@ -0,0 +1,86 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "datasample",
+    "category": "stats/random",
+    "keywords": [
+        "datasample",
+        "random",
+        "sample",
+        "replacement",
+        "weights",
+        "statistics"
+    ],
+    "summary": "Randomly sample from data with or without replacement.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host for compatibility until provider sampling hooks exist."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::random::sampling::tests",
+        "integration": null
+    },
+    "description": "`datasample(data,k)` samples `k` observations from `data`. `datasample(data,k,dim)` samples along a selected dimension. `[y,idx] = datasample(...)` also returns one-based sampled indices.",
+    "behaviors": [
+        "Samples with replacement by default.",
+        "`\"Replace\",false` samples without replacement and requires `k` to be no larger than the sampled dimension.",
+        "`\"Weights\",w` samples proportionally to nonnegative weights with at least one positive value.",
+        "Numeric, logical, string, and char arrays are supported.",
+        "The default sampled dimension is the first nonsingleton dimension."
+    ],
+    "examples": [
+        {
+            "description": "Sample rows",
+            "input": "Y = datasample(X, 5)"
+        },
+        {
+            "description": "Sample columns without replacement",
+            "input": "Y = datasample(X, 3, 2, \"Replace\", false)"
+        },
+        {
+            "description": "Return sampled indices",
+            "input": "[Y,idx] = datasample(X, 10)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does datasample change RNG state?",
+            "answer": "Yes. It uses RunMat's global random stream, like other random builtins."
+        }
+    ],
+    "links": [
+        {
+            "label": "randsample",
+            "url": "./randsample"
+        },
+        {
+            "label": "randperm",
+            "url": "./randperm"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/random/sampling.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/random/sampling.rs"
+    },
+    "key": "datasample",
+    "slug": "datasample",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "random"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=datasample.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datasample.js","sourceRoot":"","sources":["../../../src/generated/builtins/datasample.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,YAAY;QACZ,QAAQ;QACR,QAAQ;QACR,aAAa;QACb,SAAS;QACT,YAAY;KACb;IACD,SAAS,EAAE,wDAAwD;IACnE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,wFAAwF;KAClG;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,0CAA0C;QAClD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,6LAA6L;IAC5M,WAAW,EAAE;QACX,sCAAsC;QACtC,8GAA8G;QAC9G,iGAAiG;QACjG,0DAA0D;QAC1D,oEAAoE;KACrE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,aAAa;YAC5B,OAAO,EAAE,sBAAsB;SAChC;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,6CAA6C;SACvD;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,6BAA6B;SACvC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,yEAAyE;SACpF;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/datetime.js

@@ -12,7 +12,7 @@ const builtinDoc = {
         "Format",
         "MATLAB compatibility"
     ],
-    "summary": "Create datetime arrays from text, components, or serial date numbers in MATLAB and RunMat.",
+    "summary": "Create datetime arrays from text, components, or serial date numbers and interoperate with MATLAB date/time helper functions.",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
@@ -30,7 +30,7 @@ const builtinDoc = {
     "tested": {
         "integration": "runmat-vm/tests/datetime.rs"
     },
-    "description": "`datetime` constructs datetime objects from component values, text inputs, and serial date-number forms. Supported creation paths and `Format` display behavior follow current MATLAB/RunMat datetime semantics.",
+    "description": "`datetime` constructs datetime objects from component values, text inputs, and serial date-number forms. Supported creation paths, `Format` display behavior, elapsed-duration arithmetic, calendar-duration arithmetic, legacy serial-date helpers, and common business-day helpers follow current MATLAB/RunMat datetime semantics.",
     "behaviors": [
         "`datetime()` with no arguments returns the current local date and time.",
         "`datetime(Y, M, D)` and `datetime(Y, M, D, H, MN, S)` construct datetimes from numeric components. Scalar inputs expand to match non-scalar component arrays.",
@@ -39,7 +39,11 @@ const builtinDoc = {
         "`datetime(serials)` also accepts raw serial date numbers for the current implementation, producing datetime values directly from those serials.",
         "The `Format` property controls text rendering. Assigning `t.Format = 'yyyy-MM-dd HH:mm:ss'` updates how the object displays without changing the stored point in time.",
         "Linear indexing `t(k)` is supported and returns datetime values.",
-        "Comparison operators and `plus`/`minus` day arithmetic are supported. Subtracting two datetime values returns numeric day deltas."
+        "Comparison operators and `plus`/`minus` day arithmetic are supported. Subtracting two datetime values returns numeric day deltas.",
+        "`now`, `today`, and `clock` expose current local time in MATLAB-compatible serial, datetime, and date-vector forms.",
+        "`datenum`, `datevec`, `datestr`, `weekday`, `eomday`, `etime`, and `isbetween` cover common legacy serial-date conversion, formatting, query, and interval operations.",
+        "`datetime + calendarDuration` and `datetime - calendarDuration` apply month-aware calendar arithmetic with end-of-month clamping.",
+        "`isbusday`, `holidays`, `busdays`, `days252bus`, `daysdif`, `fbusdate`, and `lbusdate` provide weekday plus market-holiday business-calendar compatibility for standard scripts. Custom weekend definitions and all Financial Toolbox option forms are not yet implemented."
     ],
     "examples": [
         {
@@ -71,6 +75,16 @@ const builtinDoc = {
             "description": "Adding days and subtracting datetimes",
             "input": "t0 = datetime(2024, 4, 9);\nt1 = t0 + 7;\ndelta = t1 - t0",
             "output": "delta = 7"
+        },
+        {
+            "description": "Using serial-date conversion helpers",
+            "input": "n = datenum(2024, 4, 9);\nv = datevec(n);\ns = datestr(n, 'yyyy-MM-dd')",
+            "output": "s =\n  2024-04-09"
+        },
+        {
+            "description": "Adding a calendar month clamps at month end",
+            "input": "t = datetime(2024, 1, 31, 'Format', 'yyyy-MM-dd');\nt + calmonths(1)",
+            "output": "ans =\n  2024-02-29"
         }
     ],
     "faqs": [
@@ -103,6 +117,14 @@ const builtinDoc = {
         {
             "label": "disp",
             "url": "./disp"
+        },
+        {
+            "label": "calendarDuration",
+            "url": "./calendarDuration"
+        },
+        {
+            "label": "duration",
+            "url": "./duration"
         }
     ],
     "source": {

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

@@ -1 +1 @@
-{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../../../src/generated/builtins/datetime.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,UAAU;QACV,MAAM;QACN,MAAM;QACN,oBAAoB;QACpB,SAAS;QACT,QAAQ;QACR,sBAAsB;KACvB;IACD,SAAS,EAAE,4FAA4F;IACvG,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,8GAA8G;KACxH;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,6BAA6B;KAC7C;IACD,aAAa,EAAE,kNAAkN;IACjO,WAAW,EAAE;QACX,yEAAyE;QACzE,+JAA+J;QAC/J,+JAA+J;QAC/J,wGAAwG;QACxG,iJAAiJ;QACjJ,wKAAwK;QACxK,kEAAkE;QAClE,mIAAmI;KACpI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wDAAwD;YACvE,OAAO,EAAE,qCAAqC;YAC9C,QAAQ,EAAE,6BAA6B;SACxC;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,iDAAiD;SAC5D;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,0DAA0D;YACnE,QAAQ,EAAE,iDAAiD;SAC5D;QACD;YACE,aAAa,EAAE,2DAA2D;YAC1E,OAAO,EAAE,kFAAkF;YAC3F,QAAQ,EAAE,qBAAqB;SAChC;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,0FAA0F;YACnG,QAAQ,EAAE,gCAAgC;SAC3C;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,2DAA2D;YACpE,QAAQ,EAAE,WAAW;SACtB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,6IAA6I;SACxJ;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,mKAAmK;SAC9K;QACD;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,yEAAyE;SACpF;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,uJAAuJ;SAClK;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;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,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,eAAe,EAAE,uOAAuO;IACxP,cAAc,EAAE;QACd,uKAAuK;KACxK;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../../../src/generated/builtins/datetime.ts"],"names":[],"mappings":"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"}

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

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

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

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

package/dist/generated/builtins/dbclear.js

@@ -0,0 +1,69 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "dbclear",
+    "category": "introspection",
+    "keywords": [
+        "dbclear",
+        "debug",
+        "breakpoints"
+    ],
+    "summary": "Clear RunMat debugger breakpoint status entries.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Host-side debugger state only."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 8,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": null,
+        "integration": "debugger_compat_commands_execute_through_core"
+    },
+    "description": "`dbclear` accepts MATLAB-style breakpoint-clear commands.",
+    "behaviors": [
+        "`dbclear all`, `dbclear in file`, `dbclear in file at location`, and `dbclear if condition` command text is accepted.",
+        "RunMat does not yet implement execution breakpoints or `dbstop`, so clearing the current empty registry is a no-op.",
+        "`dbclear` is a sink and returns no output."
+    ],
+    "examples": [
+        {
+            "description": "Clear all breakpoint state",
+            "input": "dbclear all"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `dbclear` remove active execution breakpoints?",
+            "answer": "RunMat does not yet have active execution breakpoints. The command is accepted and clears the currently empty registry."
+        }
+    ],
+    "links": [
+        {
+            "label": "dbstatus",
+            "url": "./dbstatus"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/introspection/debugging.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/introspection/debugging.rs"
+    },
+    "gpu_behavior": [
+        "`dbclear` is host-side debugger state and has no GPU/provider behavior."
+    ],
+    "key": "dbclear",
+    "slug": "dbclear",
+    "aliases": [],
+    "categoryPath": [
+        "introspection"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=dbclear.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dbclear.js","sourceRoot":"","sources":["../../../src/generated/builtins/dbclear.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,SAAS;QACT,OAAO;QACP,aAAa;KACd;IACD,SAAS,EAAE,kDAAkD;IAC7D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gCAAgC;KAC1C;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,IAAI;QACZ,aAAa,EAAE,+CAA+C;KAC/D;IACD,aAAa,EAAE,2DAA2D;IAC1E,WAAW,EAAE;QACX,uHAAuH;QACvH,qHAAqH;QACrH,4CAA4C;KAC7C;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,aAAa;SACvB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qDAAqD;YACjE,QAAQ,EAAE,yHAAyH;SACpI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iEAAiE;QAC1E,KAAK,EAAE,8GAA8G;KACtH;IACD,cAAc,EAAE;QACd,yEAAyE;KAC1E;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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