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

package/dist/generated/builtins/open.js

@@ -0,0 +1,114 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "open",
+    "category": "io/repl_fs",
+    "keywords": [
+        "open",
+        "file",
+        "MAT-file",
+        "viewer",
+        "extension handler"
+    ],
+    "summary": "Open a file or variable using MATLAB-compatible dispatch.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Host-side file and workspace dispatch. gpuArray filename inputs are gathered before lookup."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::io::repl_fs::open::tests"
+    },
+    "description": "`open(name)` resolves a workspace variable or file name using RunMat's MATLAB-style search path. MAT-files are loaded and returned as a struct, RunMat figure scene payloads return a figure handle, custom `open<extension>` handlers are invoked when available, and ordinary editor/viewer file types succeed with an empty result in noninteractive hosts.",
+    "behaviors": [
+        "`open name` and `A = open(name)` accept a string scalar or row character vector.",
+        "Workspace variable names are accepted as editor-style opens and return an empty 0-by-0 array.",
+        "Names without an extension are searched on the current RunMat path using MATLAB-like file extensions.",
+        "Names with an explicit extension are first searched exactly on the current RunMat path so custom extensions such as `.log` can dispatch to `openlog`.",
+        "MAT-files are decoded through the same implementation as `load` and return a scalar struct with one field per variable.",
+        "`.fig` files first try RunMat figure-scene import and return a numeric figure handle when successful; otherwise RunMat decodes them as MAT-file containers until full MATLAB figure reconstruction is available.",
+        "For non-MAT files, RunMat looks for a semantic handler named `open<extension>` and passes the resolved file path as a string.",
+        "Known text, script, project/model, document, toolbox/install, executable, and spreadsheet file extensions open as no-op viewer/editor requests and return an empty 0-by-0 array.",
+        "Requesting more than one output raises `RunMat:open:TooManyOutputs`.",
+        "Unsupported file types without a handler raise `RunMat:open:UnsupportedFileType`."
+    ],
+    "examples": [
+        {
+            "description": "Load a MAT-file through open",
+            "input": "S = open('results.mat')",
+            "output": "% S is a struct containing the variables stored in results.mat."
+        },
+        {
+            "description": "Open a script from the current path",
+            "input": "open setup",
+            "output": "% setup.m is resolved and treated as an editor/viewer open."
+        },
+        {
+            "description": "Open a figure scene",
+            "input": "h = open('plot.fig')",
+            "output": "% h is a figure handle when plot.fig contains a RunMat figure scene payload."
+        },
+        {
+            "description": "Dispatch to a custom extension handler",
+            "input": "function out = openabc(filename)\n    out = fileread(filename);\nend\nout = open('payload.abc')",
+            "output": "% openabc receives the resolved filename and returns its output."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `open` launch a desktop editor or external application?",
+            "answer": "No. RunMat's runtime implementation is host-safe and noninteractive. It resolves the target and performs data-returning work where possible; viewer/editor opens complete as no-ops."
+        },
+        {
+            "question": "How is `open('file.mat')` different from `load('file.mat')`?",
+            "answer": "For MAT-files, `open` returns the same struct-style data that `load` returns when called with one output."
+        },
+        {
+            "question": "Can user code customize how an extension opens?",
+            "answer": "Yes. Define a function named `open` followed by the lowercase extension, for example `openabc` for `.abc` files. RunMat calls that handler with the resolved filename."
+        }
+    ],
+    "links": [
+        {
+            "label": "load",
+            "url": "./load"
+        },
+        {
+            "label": "which",
+            "url": "./which"
+        },
+        {
+            "label": "exist",
+            "url": "./exist"
+        },
+        {
+            "label": "run",
+            "url": "./run"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/io/repl_fs/open.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/io/repl_fs/open.rs"
+    },
+    "gpu_behavior": [
+        "`open` is an I/O dispatcher and does not participate in GPU fusion or provider-native execution."
+    ],
+    "key": "open",
+    "slug": "open",
+    "aliases": [],
+    "categoryPath": [
+        "io",
+        "repl_fs"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=open.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../../src/generated/builtins/open.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,MAAM;QACN,MAAM;QACN,UAAU;QACV,QAAQ;QACR,mBAAmB;KACpB;IACD,SAAS,EAAE,2DAA2D;IACtE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,6FAA6F;KACvG;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,oCAAoC;KAC7C;IACD,aAAa,EAAE,gWAAgW;IAC/W,WAAW,EAAE;QACX,kFAAkF;QAClF,+FAA+F;QAC/F,uGAAuG;QACvG,uJAAuJ;QACvJ,yHAAyH;QACzH,kNAAkN;QAClN,+HAA+H;QAC/H,kLAAkL;QAClL,sEAAsE;QACtE,mFAAmF;KACpF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,yBAAyB;YAClC,QAAQ,EAAE,iEAAiE;SAC5E;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,YAAY;YACrB,QAAQ,EAAE,6DAA6D;SACxE;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,sBAAsB;YAC/B,QAAQ,EAAE,8EAA8E;SACzF;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,iGAAiG;YAC1G,QAAQ,EAAE,kEAAkE;SAC7E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,8DAA8D;YAC1E,QAAQ,EAAE,sLAAsL;SACjM;QACD;YACE,UAAU,EAAE,8DAA8D;YAC1E,QAAQ,EAAE,2GAA2G;SACtH;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,wKAAwK;SACnL;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,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,yDAAyD;QAClE,KAAK,EAAE,sGAAsG;KAC9G;IACD,cAAc,EAAE;QACd,kGAAkG;KACnG;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/openfig.js

@@ -0,0 +1,70 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "openfig",
+    "category": "plotting",
+    "keywords": [
+        "openfig",
+        "figure open",
+        "fig",
+        "plotting"
+    ],
+    "summary": "Open figures saved in RunMat FIG files.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`openfig` is an I/O and plotting-state operation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "requires_feature": "plot-core",
+    "tested": {
+        "unit": "builtins::plotting::figure_persistence::tests",
+        "integration": "single and multiple figure round-trip tests"
+    },
+    "description": "`openfig(filename)` loads a RunMat FIG scene file and returns the imported figure handle or a row vector of handles.",
+    "behaviors": [
+        "The `.fig` extension is appended when the filename has no extension.",
+        "`openfig(filename, 'new')` imports a new copy of the saved scene. `reuse` mode is rejected until RunMat tracks figure-file reuse relationships.",
+        "`openfig(..., 'visible')` and `openfig(..., 'invisible')` override the loaded figure visibility."
+    ],
+    "examples": [
+        {
+            "description": "Open an invisible figure in visible state",
+            "input": "plot(1:5);\nset(gcf, \"Visible\", \"off\");\nsavefig(\"hidden_plot.fig\");\nfig = openfig(\"hidden_plot.fig\", \"visible\");"
+        }
+    ],
+    "links": [
+        {
+            "label": "savefig",
+            "url": "./savefig"
+        },
+        {
+            "label": "hgload",
+            "url": "./hgload"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/figure_persistence.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/figure_persistence.rs"
+    },
+    "gpu_residency": "`openfig` returns host graphics handles and creates plotting state in the runtime registry.",
+    "gpu_behavior": [
+        "No numeric GPU kernel is launched.",
+        "Loaded figure content can later render through the normal plotting renderer."
+    ],
+    "key": "openfig",
+    "slug": "openfig",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=openfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openfig.js","sourceRoot":"","sources":["../../../src/generated/builtins/openfig.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,aAAa;QACb,KAAK;QACL,UAAU;KACX;IACD,SAAS,EAAE,yCAAyC;IACpD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mDAAmD;KAC7D;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,WAAW;IAC/B,QAAQ,EAAE;QACR,MAAM,EAAE,+CAA+C;QACvD,aAAa,EAAE,6CAA6C;KAC7D;IACD,aAAa,EAAE,sHAAsH;IACrI,WAAW,EAAE;QACX,sEAAsE;QACtE,iJAAiJ;QACjJ,kGAAkG;KACnG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,8HAA8H;SACxI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,yEAAyE;QAClF,KAAK,EAAE,sHAAsH;KAC9H;IACD,eAAe,EAAE,6FAA6F;IAC9G,cAAc,EAAE;QACd,oCAAoC;QACpC,8EAA8E;KAC/E;IACD,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/opengl.d.ts

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

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

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

package/dist/generated/builtins/opengl.js

@@ -0,0 +1,71 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "opengl",
+    "category": "plotting",
+    "keywords": [
+        "opengl",
+        "renderer",
+        "graphics",
+        "plotting"
+    ],
+    "summary": "Report deterministic RunMat renderer compatibility information.",
+    "status": "done",
+    "version_added": "0.5.3",
+    "tests": {
+        "unit": "builtins::plotting::opengl::tests"
+    },
+    "description": "`opengl` provides MATLAB-compatible renderer status and information commands for scripts that probe or select graphics rendering modes. RunMat maps these calls onto the `runmat-plot` renderer instead of exposing a process-global native OpenGL switch.",
+    "syntax": [
+        "status = opengl",
+        "info = opengl('info')",
+        "data = opengl('data')",
+        "status = opengl('hardware')",
+        "status = opengl('hardwarebasic')",
+        "status = opengl('software')",
+        "status = opengl('save', mode)"
+    ],
+    "arguments": [
+        {
+            "name": "command",
+            "type": "text scalar",
+            "description": "Renderer command: `info`, `data`, `hardware`, `hardwarebasic`, `software`, `save`, `autoselect`, or `neverselect`. `opengl('save', mode)` accepts `hardware`, `hardwarebasic`, `software`, `autoselect`, or `none`."
+        }
+    ],
+    "examples": [
+        {
+            "description": "Query renderer information",
+            "input": "info = opengl('info');\ninfo.Renderer",
+            "output": "ans = 'runmat-plot'"
+        }
+    ],
+    "notes": [
+        "`opengl('info')` and `opengl('data')` return a struct with MATLAB-style fields such as `Version`, `Vendor`, `Renderer`, `HardwareSupportLevel`, `Software`, and `MaxTextureSize`.",
+        "Mode-selection commands are deterministic compatibility operations; they do not replace the `runmat-plot` backend or install a native OpenGL context."
+    ],
+    "gpu_residency": "`opengl` reports renderer metadata only. It does not affect gpuArray residency or provider dispatch.",
+    "related": [
+        {
+            "label": "figure",
+            "url": "./figure"
+        },
+        {
+            "label": "drawnow",
+            "url": "./drawnow"
+        }
+    ],
+    "implemented_in": [
+        {
+            "label": "crates/runmat-runtime/src/builtins/plotting/ops/opengl.rs",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/opengl.rs"
+        }
+    ],
+    "key": "opengl",
+    "slug": "opengl",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=opengl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opengl.js","sourceRoot":"","sources":["../../../src/generated/builtins/opengl.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,UAAU;QACV,UAAU;QACV,UAAU;KACX;IACD,SAAS,EAAE,iEAAiE;IAC5E,QAAQ,EAAE,MAAM;IAChB,eAAe,EAAE,OAAO;IACxB,OAAO,EAAE;QACP,MAAM,EAAE,mCAAmC;KAC5C;IACD,aAAa,EAAE,4PAA4P;IAC3Q,QAAQ,EAAE;QACR,iBAAiB;QACjB,uBAAuB;QACvB,uBAAuB;QACvB,6BAA6B;QAC7B,kCAAkC;QAClC,6BAA6B;QAC7B,+BAA+B;KAChC;IACD,WAAW,EAAE;QACX;YACE,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,aAAa;YACrB,aAAa,EAAE,qNAAqN;SACrO;KACF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,qBAAqB;SAChC;KACF;IACD,OAAO,EAAE;QACP,mLAAmL;QACnL,uJAAuJ;KACxJ;IACD,eAAe,EAAE,sGAAsG;IACvH,SAAS,EAAE;QACT;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,gBAAgB,EAAE;QAChB;YACE,OAAO,EAAE,2DAA2D;YACpE,KAAK,EAAE,0GAA0G;SAClH;KACF;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/opentoline.js

@@ -0,0 +1,101 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "opentoline",
+    "category": "io/repl_fs",
+    "keywords": [
+        "opentoline",
+        "open",
+        "editor",
+        "file",
+        "line",
+        "column"
+    ],
+    "summary": "Open a file to a requested editor line in MATLAB-compatible code.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Host-side editor navigation request. gpuArray scalar position inputs are gathered before validation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 4,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::io::repl_fs::opentoline::tests",
+        "vm": "basics::opentoline_dispatches_editor_navigation_request"
+    },
+    "description": "`opentoline(filename,line)` resolves a file and validates a host-safe editor-navigation request. RunMat runtimes are noninteractive, so successful calls complete without launching an editor.",
+    "behaviors": [
+        "`opentoline(filename,line)` accepts a string scalar, row character vector, or scalar string array filename plus a positive integer line number.",
+        "`opentoline(filename,line,column)` also validates a positive integer column number.",
+        "`opentoline(filename,line,column,'select')` accepts MATLAB-style selection intent as a no-op navigation option in noninteractive hosts.",
+        "Command-style numeric line and column arguments passed as text, such as `opentoline file.m 10 4`, are accepted when they parse as positive integers.",
+        "File names are resolved using the RunMat search path and the same general MATLAB-style file extensions used by `open`.",
+        "A missing file raises `RunMat:opentoline:FileNotFound`.",
+        "Non-scalar, nonfinite, fractional, zero, or negative line and column values raise `RunMat:opentoline:InvalidPosition`.",
+        "Requesting output arguments raises `RunMat:opentoline:TooManyOutputs`."
+    ],
+    "examples": [
+        {
+            "description": "Open a script at a line",
+            "input": "opentoline('setup.m', 12)",
+            "output": "% setup.m is resolved and the editor-navigation request succeeds without returned output."
+        },
+        {
+            "description": "Open a script at a line and column",
+            "input": "opentoline('setup.m', 12, 4)",
+            "output": "% RunMat validates the file, line, and column."
+        },
+        {
+            "description": "Use command-style text numbers",
+            "input": "opentoline setup.m 12 4",
+            "output": "% Text line and column arguments are parsed as positive integers."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `opentoline` launch a desktop editor?",
+            "answer": "No. RunMat's runtime implementation is host-safe and noninteractive. It resolves the file and validates the requested position; the actual editor navigation completes as a no-op."
+        },
+        {
+            "question": "Why is this builtin under `io/repl_fs` instead of plotting?",
+            "answer": "`opentoline` is an editor/file navigation helper. It appeared in a plotting/UI token bucket, but its runtime ownership belongs with REPL-facing filesystem and editor-style operations."
+        }
+    ],
+    "links": [
+        {
+            "label": "open",
+            "url": "./open"
+        },
+        {
+            "label": "which",
+            "url": "./which"
+        },
+        {
+            "label": "exist",
+            "url": "./exist"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/io/repl_fs/opentoline.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/io/repl_fs/opentoline.rs"
+    },
+    "gpu_behavior": [
+        "`opentoline` is a host-side editor navigation operation and does not participate in GPU fusion or provider-native execution."
+    ],
+    "key": "opentoline",
+    "slug": "opentoline",
+    "aliases": [],
+    "categoryPath": [
+        "io",
+        "repl_fs"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=opentoline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opentoline.js","sourceRoot":"","sources":["../../../src/generated/builtins/opentoline.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,YAAY;QACZ,MAAM;QACN,QAAQ;QACR,MAAM;QACN,MAAM;QACN,QAAQ;KACT;IACD,SAAS,EAAE,mEAAmE;IAC9E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,sGAAsG;KAChH;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,0CAA0C;QAClD,IAAI,EAAE,yDAAyD;KAChE;IACD,aAAa,EAAE,gMAAgM;IAC/M,WAAW,EAAE;QACX,iJAAiJ;QACjJ,qFAAqF;QACrF,yIAAyI;QACzI,sJAAsJ;QACtJ,wHAAwH;QACxH,yDAAyD;QACzD,wHAAwH;QACxH,wEAAwE;KACzE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,2BAA2B;YACpC,QAAQ,EAAE,2FAA2F;SACtG;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,gDAAgD;SAC3D;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yBAAyB;YAClC,QAAQ,EAAE,mEAAmE;SAC9E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,oLAAoL;SAC/L;QACD;YACE,UAAU,EAAE,6DAA6D;YACzE,QAAQ,EAAE,yLAAyL;SACpM;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,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,cAAc,EAAE;QACd,8HAA8H;KAC/H;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/optimizableVariable.js

@@ -0,0 +1,52 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "optimizableVariable",
+    "category": "stats/ml",
+    "keywords": [
+        "optimizableVariable",
+        "bayesopt",
+        "optimization",
+        "variable"
+    ],
+    "summary": "Create Bayesian optimization variable metadata.",
+    "description": "`optimizableVariable(Name,Range)` constructs a host metadata object describing a variable for Bayesian optimization workflows.",
+    "behaviors": [
+        "The variable name must be a nonempty text scalar.",
+        "Numeric ranges must contain exactly two finite, increasing bounds and default to `Type` `real`.",
+        "`Type` accepts `real`, `integer`, and `categorical`; integer ranges must use whole-number bounds.",
+        "Categorical ranges are accepted as string arrays, scalar strings with explicit `Type` `categorical`, or cell arrays of text scalars and must be nonempty and unique.",
+        "`Transform` accepts `none` and `log`; log transforms require positive real lower bounds or nonnegative integer lower bounds and are not accepted for categorical variables.",
+        "`Optimize` accepts scalar logical values and defaults to true.",
+        "The result is an `optimizableVariable` compatibility object with `Name`, `Range`, `Type`, `Transform`, and `Optimize` properties."
+    ],
+    "examples": [
+        {
+            "description": "Real Variable",
+            "input": "v = optimizableVariable(\"depth\", [1 10])",
+            "output": "optimizableVariable compatibility object."
+        },
+        {
+            "description": "Categorical Variable",
+            "input": "v = optimizableVariable(\"kernel\", [\"linear\" \"rbf\"], \"Type\", \"categorical\")",
+            "output": "optimizableVariable compatibility object."
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "v = optimizableVariable(Name, Range)\nv = optimizableVariable(Name, Range, Name, Value)",
+            "output": "optimizableVariable compatibility object."
+        }
+    },
+    "gpu_residency": "`optimizableVariable` constructs host metadata for `bayesopt`; gpuArray range and option inputs are gathered before validation.",
+    "key": "optimizablevariable",
+    "slug": "optimizablevariable",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "ml"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=optimizableVariable.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optimizableVariable.js","sourceRoot":"","sources":["../../../src/generated/builtins/optimizableVariable.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,qBAAqB;IAC9B,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,qBAAqB;QACrB,UAAU;QACV,cAAc;QACd,UAAU;KACX;IACD,SAAS,EAAE,iDAAiD;IAC5D,aAAa,EAAE,gIAAgI;IAC/I,WAAW,EAAE;QACX,mDAAmD;QACnD,iGAAiG;QACjG,mGAAmG;QACnG,sKAAsK;QACtK,6KAA6K;QAC7K,gEAAgE;QAChE,mIAAmI;KACpI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,eAAe;YAC9B,OAAO,EAAE,4CAA4C;YACrD,QAAQ,EAAE,2CAA2C;SACtD;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,sFAAsF;YAC/F,QAAQ,EAAE,2CAA2C;SACtD;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,yFAAyF;YAClG,QAAQ,EAAE,2CAA2C;SACtD;KACF;IACD,eAAe,EAAE,iIAAiI;IAClJ,KAAK,EAAE,qBAAqB;IAC5B,MAAM,EAAE,qBAAqB;IAC7B,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/ordinal.js

@@ -0,0 +1,80 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "ordinal",
+    "category": "table",
+    "keywords": [
+        "ordinal",
+        "categorical",
+        "categories",
+        "statistics"
+    ],
+    "summary": "Create an ordinal categorical array object.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Ordinal categorical arrays are host metadata objects."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::table::tests::ordinal_constructor_sets_ordered_categorical_semantics",
+        "integration": "crates/runmat-vm/tests/tables_timetables.rs"
+    },
+    "description": "`ordinal(A)` creates a categorical object whose categories are ordered. It is a compatibility constructor equivalent to `categorical(..., 'Ordinal', true)`.",
+    "behaviors": [
+        "String, char, cellstr, numeric, and logical inputs are accepted through the same label conversion path as `categorical`.",
+        "`ordinal(A)` derives sorted unique categories from non-missing labels.",
+        "`ordinal(A, categories)` uses the supplied category order and marks labels not present in that list as missing.",
+        "`ordinal(A, valueset, catnames)` maps source values through `valueset` and stores the corresponding category names from `catnames`.",
+        "The returned object has class `categorical`, stores one-based category codes, and has its `Ordinal` metadata flag set to true.",
+        "Equality and relational operators compare category order; categorical-to-categorical comparisons require matching category lists.",
+        "`min` and `max` reduce ordinal categorical arrays by category order and return categorical results; undefined elements follow the numeric `NaN` behavior of `includenan` and `omitnan`, and multi-output forms return numeric indices."
+    ],
+    "examples": [
+        {
+            "description": "Create an ordered categorical array",
+            "input": "O = ordinal({'medium'; 'low'}, {'low','medium','high'})",
+            "output": "O = categorical object"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How is `ordinal` different from `categorical`?",
+            "answer": "`ordinal` always sets the categorical `Ordinal` flag to true, so category order is meaningful for compatibility code that checks ordinal categorical metadata."
+        }
+    ],
+    "links": [
+        {
+            "label": "categorical",
+            "url": "./categorical"
+        },
+        {
+            "label": "iscategorical",
+            "url": "./iscategorical"
+        },
+        {
+            "label": "isordinal",
+            "url": "./isordinal"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/table/builtins/constructors.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/table/builtins/constructors.rs"
+    },
+    "key": "ordinal",
+    "slug": "ordinal",
+    "aliases": [],
+    "categoryPath": [
+        "table"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=ordinal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ordinal.js","sourceRoot":"","sources":["../../../src/generated/builtins/ordinal.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,SAAS;QACT,aAAa;QACb,YAAY;QACZ,YAAY;KACb;IACD,SAAS,EAAE,6CAA6C;IACxD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,uDAAuD;KACjE;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,gFAAgF;QACxF,aAAa,EAAE,6CAA6C;KAC7D;IACD,aAAa,EAAE,8JAA8J;IAC7K,WAAW,EAAE;QACX,0HAA0H;QAC1H,wEAAwE;QACxE,iHAAiH;QACjH,qIAAqI;QACrI,gIAAgI;QAChI,mIAAmI;QACnI,wOAAwO;KACzO;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,yDAAyD;YAClE,QAAQ,EAAE,wBAAwB;SACnC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,gKAAgK;SAC3K;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,iBAAiB;SACzB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qEAAqE;QAC9E,KAAK,EAAE,kHAAkH;KAC1H;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/outdegree.js

@@ -0,0 +1,36 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "outdegree",
+    "category": "graph",
+    "keywords": [
+        "outdegree",
+        "digraph",
+        "graph",
+        "nodes"
+    ],
+    "summary": "Return directed node out-degree counts.",
+    "status": "implemented",
+    "tested": {
+        "unit": "builtins::graph::tests"
+    },
+    "description": "`outdegree(G)` returns one out-degree value per node. For undirected graphs, RunMat returns the undirected degree counts.",
+    "signatures": [
+        {
+            "label": "d = outdegree(G)",
+            "description": "Return a column vector of out-degree counts."
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/graph/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/graph/mod.rs"
+    },
+    "key": "outdegree",
+    "slug": "outdegree",
+    "aliases": [],
+    "categoryPath": [
+        "graph"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=outdegree.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outdegree.js","sourceRoot":"","sources":["../../../src/generated/builtins/outdegree.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,SAAS;QACT,OAAO;QACP,OAAO;KACR;IACD,SAAS,EAAE,yCAAyC;IACpD,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE;QACR,MAAM,EAAE,wBAAwB;KACjC;IACD,aAAa,EAAE,2HAA2H;IAC1I,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,kBAAkB;YAC3B,aAAa,EAAE,8CAA8C;SAC9D;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/padsequences.d.ts

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

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

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