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

package/dist/generated/builtins/spreadsheetImportOptions.js

@@ -0,0 +1,93 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "spreadsheetImportOptions",
+    "category": "io/tabular",
+    "keywords": [
+        "spreadsheetImportOptions",
+        "readtable",
+        "spreadsheet",
+        "xlsx",
+        "xls",
+        "DataRange",
+        "VariableTypes"
+    ],
+    "summary": "Create spreadsheet import options structs for `readtable`.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Builds host-side import metadata. File I/O and parsing happen later when the options are passed to `readtable`."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::table::tests",
+        "integration": "builtins::table::tests::readtable_consumes_spreadsheet_import_options_struct"
+    },
+    "description": "`opts = spreadsheetImportOptions(...)` returns an editable import-options struct accepted by `readtable` for spreadsheet files. The struct supports MATLAB-style dot assignment before import, including data ranges, sheet selection, variable names, and variable types.",
+    "behaviors": [
+        "Accepts name-value options including `'NumVariables'`, `'VariableNames'`, `'VariableTypes'`, `'DataRange'`, `'Range'`, `'Sheet'`, `'ReadVariableNames'`, `'ReadRowNames'`, `'TreatAsMissing'`, `'VariableNamingRule'`, `'TextType'`, `'DatetimeType'`, and `'EmptyLineRule'`.",
+        "`'NumVariables'` creates default `Var1`, `Var2`, ... names and `auto` variable types; edited `VariableNames` and `VariableTypes` are validated against that count.",
+        "`DataRange` is treated as the spreadsheet cell range for `readtable`, matching the common MATLAB workflow `opts.DataRange = 'C2:C37'`.",
+        "`VariableTypes` entries guide import coercion for double, single, uint8, uint16, logical, string, char, cellstr, datetime, and duration columns.",
+        "Requests for table column classes that RunMat cannot represent yet, including categorical and signed integer array imports, raise explicit errors instead of silently returning a different class.",
+        "Default options do not force a zero-column import; `readtable` infers the column count unless a positive `NumVariables` is supplied.",
+        "Invalid option names, malformed ranges, unsupported sheets, and unparseable typed values raise descriptive `readtable` errors instead of silently changing the schema."
+    ],
+    "examples": [
+        {
+            "description": "Import A Spreadsheet Column With An Options Struct",
+            "input": "opts = spreadsheetImportOptions('NumVariables', 1);\nopts.DataRange = 'C2:C37';\nopts.VariableNames = {'Amount'};\nopts.VariableTypes = {'double'};\nT = readtable('data.xlsx', opts)"
+        },
+        {
+            "description": "Select A Worksheet And Preserve Variable Names",
+            "input": "opts = spreadsheetImportOptions('Sheet', 'Data', 'VariableNamingRule', 'preserve');\nT = readtable('workbook.xlsx', opts)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Is the returned value an object?",
+            "answer": "RunMat represents import options as a scalar struct so MATLAB-style field assignment works naturally and `readtable` can consume the same value directly."
+        },
+        {
+            "question": "What happens if `VariableTypes` asks for a type that cannot parse a column?",
+            "answer": "`readtable` raises a typed import error for the offending non-missing value. It does not fall back to a string column when the schema explicitly requested another type."
+        },
+        {
+            "question": "Can I use the options with text files?",
+            "answer": "The constructor is spreadsheet-focused, but the struct fields that also apply to text imports are parsed by `readtable`; spreadsheet-only fields such as `Sheet` remain valid only for spreadsheet files."
+        }
+    ],
+    "links": [
+        {
+            "label": "readtable",
+            "url": "./readtable"
+        },
+        {
+            "label": "readmatrix",
+            "url": "./readmatrix"
+        }
+    ],
+    "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"
+    },
+    "gpu_residency": "No GPU work is performed. Options are host metadata, and later `readtable` imports create host table variables.",
+    "key": "spreadsheetimportoptions",
+    "slug": "spreadsheetimportoptions",
+    "aliases": [],
+    "categoryPath": [
+        "io",
+        "tabular"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=spreadsheetImportOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spreadsheetImportOptions.js","sourceRoot":"","sources":["../../../src/generated/builtins/spreadsheetImportOptions.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,0BAA0B;IACnC,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,0BAA0B;QAC1B,WAAW;QACX,aAAa;QACb,MAAM;QACN,KAAK;QACL,WAAW;QACX,eAAe;KAChB;IACD,SAAS,EAAE,4DAA4D;IACvE,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,iHAAiH;KAC3H;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,8EAA8E;KAC9F;IACD,aAAa,EAAE,4QAA4Q;IAC3R,WAAW,EAAE;QACX,+QAA+Q;QAC/Q,oKAAoK;QACpK,wIAAwI;QACxI,kJAAkJ;QAClJ,oMAAoM;QACpM,sIAAsI;QACtI,wKAAwK;KACzK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,uLAAuL;SACjM;QACD;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,2HAA2H;SACrI;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,2JAA2J;SACtK;QACD;YACE,UAAU,EAAE,6EAA6E;YACzF,QAAQ,EAAE,0KAA0K;SACrL;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,2MAA2M;SACtN;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mDAAmD;QAC5D,KAAK,EAAE,gGAAgG;KACxG;IACD,eAAe,EAAE,iHAAiH;IAClI,KAAK,EAAE,0BAA0B;IACjC,MAAM,EAAE,0BAA0B;IAClC,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/sym.js

@@ -0,0 +1,78 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "sym",
+    "category": "math/symbolic",
+    "keywords": [
+        "sym",
+        "symbolic",
+        "variable",
+        "algebra"
+    ],
+    "summary": "Create a scalar symbolic variable or constant.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Symbolic expressions are host algebra values and are not uploaded to GPU providers."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::symbolic::sym::tests",
+        "integration": "runmat_vm::bytecode::compile::tests::compile_interprets_symbolic_limit_workflow"
+    },
+    "description": "`sym` creates scalar symbolic variables from identifier text and scalar symbolic constants from numeric input. Nonconstant symbolic values remain symbolic through supported arithmetic, trigonometric, and limit operations.",
+    "behaviors": [
+        "Text that is a valid MATLAB identifier creates a symbolic variable with that name.",
+        "Finite numeric, integer, logical, and scalar numeric tensor inputs create scalar symbolic constants with class `sym`.",
+        "Text containing a finite numeric scalar creates that numeric symbolic constant.",
+        "Symbolic values are host-only and do not participate in GPU fusion or residency."
+    ],
+    "examples": [
+        {
+            "description": "Create a symbolic variable",
+            "input": "x = sym('x')"
+        },
+        {
+            "description": "Create a symbolic numeric constant",
+            "input": "a = sym(2)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `sym` create symbolic arrays?",
+            "answer": "No. RunMat currently represents scalar symbolic expressions; array-valued symbolic containers are not materialized."
+        }
+    ],
+    "links": [
+        {
+            "label": "syms",
+            "url": "./syms"
+        },
+        {
+            "label": "limit",
+            "url": "./limit"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/symbolic/sym.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/symbolic/sym.rs"
+    },
+    "key": "sym",
+    "slug": "sym",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "symbolic"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=sym.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sym.js","sourceRoot":"","sources":["../../../src/generated/builtins/sym.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,KAAK;QACL,UAAU;QACV,UAAU;QACV,SAAS;KACV;IACD,SAAS,EAAE,gDAAgD;IAC3D,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qFAAqF;KAC/F;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,sCAAsC;QAC9C,aAAa,EAAE,iFAAiF;KACjG;IACD,aAAa,EAAE,+NAA+N;IAC9O,WAAW,EAAE;QACX,oFAAoF;QACpF,uHAAuH;QACvH,iFAAiF;QACjF,kFAAkF;KACnF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,cAAc;SACxB;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,YAAY;SACtB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,qHAAqH;SAChI;KACF;IACD,OAAO,EAAE;QACP;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,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/syms.js

@@ -0,0 +1,84 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "syms",
+    "category": "math/symbolic",
+    "keywords": [
+        "syms",
+        "symbolic",
+        "variable",
+        "workspace"
+    ],
+    "summary": "Declare scalar symbolic variables in the active workspace.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`syms` mutates the caller workspace and produces host-only symbolic values."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::symbolic::syms::tests",
+        "integration": "runmat_vm::bytecode::compile::tests::compile_interprets_symbolic_limit_workflow",
+        "symbolic_function": "runmat_vm::bytecode::compile::tests::compile_interprets_symbolic_function_declaration_workflow"
+    },
+    "description": "`syms` supports MATLAB command syntax such as `syms x h`, symbolic function declarations such as `syms Y(X)`, and string function syntax such as `syms('x')` by declaring each named symbol in the caller workspace before later expressions are resolved.",
+    "behaviors": [
+        "Command syntax is supported for identifiers, for example `syms x h`; function syntax supports literal text names, for example `syms('x')`.",
+        "Declared identifiers are assigned scalar symbolic variables of the same name in the active workspace.",
+        "Symbolic function declarations such as `syms Y(X)` assign `X` as a symbolic variable and `Y` as a symbolic function expression. Calls such as `Y(0)` then produce symbolic applications rather than numeric indexing.",
+        "Common assumption tokens after the first declaration, such as `real`, `positive`, and `integer`, are accepted and ignored by the current scalar symbolic core.",
+        "`syms` is a sink builtin: it does not print or return a useful value when called as a statement."
+    ],
+    "examples": [
+        {
+            "description": "Declare two symbolic variables",
+            "input": "syms x h"
+        },
+        {
+            "description": "Use declared variables in a symbolic expression",
+            "input": "syms x\nf = sin(x)/x"
+        },
+        {
+            "description": "Declare and apply a symbolic function",
+            "input": "syms Y(X)\ncond = Y(0) == 0\ndydx = diff(Y, X)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Are symbolic assumptions enforced?",
+            "answer": "Assumption tokens are parsed for MATLAB command compatibility, but the current scalar symbolic evaluator treats expressions as real-valued and does not maintain an assumption database."
+        }
+    ],
+    "links": [
+        {
+            "label": "sym",
+            "url": "./sym"
+        },
+        {
+            "label": "limit",
+            "url": "./limit"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/symbolic/syms.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/symbolic/syms.rs"
+    },
+    "key": "syms",
+    "slug": "syms",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "symbolic"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=syms.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syms.js","sourceRoot":"","sources":["../../../src/generated/builtins/syms.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,UAAU;QACV,UAAU;QACV,WAAW;KACZ;IACD,SAAS,EAAE,4DAA4D;IACvE,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,6EAA6E;KACvF;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,uCAAuC;QAC/C,aAAa,EAAE,iFAAiF;QAChG,mBAAmB,EAAE,gGAAgG;KACtH;IACD,aAAa,EAAE,4PAA4P;IAC3Q,WAAW,EAAE;QACX,4IAA4I;QAC5I,uGAAuG;QACvG,uNAAuN;QACvN,gKAAgK;QAChK,kGAAkG;KACnG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,UAAU;SACpB;QACD;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,sBAAsB;SAChC;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,gDAAgD;SAC1D;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,0LAA0L;SACrM;KACF;IACD,OAAO,EAAE;QACP;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,4DAA4D;QACrE,KAAK,EAAE,yGAAyG;KACjH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/tripuls.js

@@ -0,0 +1,91 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "tripuls",
+    "category": "math/signal",
+    "keywords": [
+        "tripuls",
+        "triangular pulse",
+        "pulse train",
+        "signal processing",
+        "skew"
+    ],
+    "summary": "Generate sampled triangular pulses.",
+    "references": [
+        "title: \"MATLAB tripuls documentation\""
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to the host and evaluated with the scalar reference implementation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline",
+        "notes": "Fusion is disabled because width and skew validation are handled by the host builtin."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::signal::tripuls::tests",
+        "integration": null
+    },
+    "description": "`tripuls(T)` returns samples of a unit-width triangular pulse centered at zero. `tripuls(T, W, S)` uses width `W` and skew `S` in `[-1, 1]`.",
+    "behaviors": [
+        "Operates element-wise on real numeric scalars, vectors, matrices, and N-D tensors; preserves input shape.",
+        "The pulse is zero outside `[-W/2, W/2]` and reaches one at `S*W/2`.",
+        "The width must be positive and finite.",
+        "The skew must be finite and in `[-1, 1]`.",
+        "Complex and text inputs are rejected with a builtin-scoped error."
+    ],
+    "examples": [
+        {
+            "description": "Default centered triangle",
+            "input": "t = -0.5:0.25:0.5;\ny = tripuls(t)",
+            "output": "y = [0 0.5 1 0.5 0]"
+        },
+        {
+            "description": "Skewed triangle",
+            "input": "t = -1:1;\ny = tripuls(t, 2, 1)",
+            "output": "y = [0 0.5 1]"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Can `tripuls` be used inside `pulstran`?",
+            "answer": "Yes. `pulstran(T, D, 'tripuls', W, S)` evaluates triangular pulses centered at each delay."
+        }
+    ],
+    "links": [
+        {
+            "label": "pulstran",
+            "url": "./pulstran"
+        },
+        {
+            "label": "rectpuls",
+            "url": "./rectpuls"
+        },
+        {
+            "label": "gauspuls",
+            "url": "./gauspuls"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/signal/tripuls.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/signal/tripuls.rs"
+    },
+    "key": "tripuls",
+    "slug": "tripuls",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "signal"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=tripuls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tripuls.js","sourceRoot":"","sources":["../../../src/generated/builtins/tripuls.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,SAAS;QACT,kBAAkB;QAClB,aAAa;QACb,mBAAmB;QACnB,MAAM;KACP;IACD,SAAS,EAAE,qCAAqC;IAChD,YAAY,EAAE;QACZ,yCAAyC;KAC1C;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,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;QACrB,OAAO,EAAE,uFAAuF;KACjG;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,wCAAwC;QAChD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,8IAA8I;IAC7J,WAAW,EAAE;QACX,2GAA2G;QAC3G,qEAAqE;QACrE,wCAAwC;QACxC,2CAA2C;QAC3C,mEAAmE;KACpE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,oCAAoC;YAC7C,QAAQ,EAAE,qBAAqB;SAChC;QACD;YACE,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,eAAe;SAC1B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,4FAA4F;SACvG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/uigetfile.js

@@ -0,0 +1,95 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "uigetfile",
+    "category": "io/repl_fs",
+    "keywords": [
+        "uigetfile",
+        "file picker",
+        "file dialog",
+        "open file",
+        "filesystem",
+        "ui"
+    ],
+    "summary": "Open a host file-selection dialog and return the selected file name and path.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Runs through the host filesystem provider. GPU-resident textual arguments are gathered before the file-selection request is made."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::io::repl_fs::uigetfile::tests",
+        "integration": "builtins::io::repl_fs::uigetfile::tests::parses_filter_title_default_and_selection_outputs"
+    },
+    "description": "`uigetfile` requests an open-file selection from the active RunMat filesystem provider and returns MATLAB-compatible output values. Interactive hosts can implement the provider hook to show a native or browser picker; noninteractive hosts return the standard cancellation values.",
+    "behaviors": [
+        "`file = uigetfile()` uses an all-files filter.",
+        "`uigetfile(filter)` accepts a character vector, string scalar, semicolon-delimited pattern list, or an N-by-1/N-by-2 cell array of patterns and descriptions.",
+        "`uigetfile(filter, title, defaultName)` forwards the dialog title and initial file or directory path to the filesystem provider.",
+        "`uigetfile(..., 'MultiSelect', 'on')` allows multiple selected files. When multiple files are selected, `file` is a cell array of character vectors. A single selected file is returned as a character vector.",
+        "The selected `path` output is the containing directory with a trailing path separator. The `index` output is the one-based selected filter index.",
+        "Cancellation returns numeric zero for `file`, `path`, and `index`, matching MATLAB. This is also the behavior for filesystem providers that do not implement an open-file picker."
+    ],
+    "examples": [
+        {
+            "description": "Select A Spreadsheet",
+            "input": "[file, path] = uigetfile('*.xlsx', 'Select a spreadsheet');\nif isequal(file, 0)\n    return;\nend\nscores = readtable(fullfile(path, file));"
+        },
+        {
+            "description": "Use Multiple Filters",
+            "input": "filters = {'*.m;*.mlx', 'MATLAB files'; '*.txt', 'Text files'};\n[file, path, index] = uigetfile(filters, 'Open source file');"
+        },
+        {
+            "description": "Allow Multiple Files",
+            "input": "[files, path] = uigetfile('*.csv', 'Select CSV files', pwd, 'MultiSelect', 'on');\nif isequal(files, 0)\n    return;\nend"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What happens in noninteractive or headless RunMat hosts?",
+            "answer": "RunMat returns the MATLAB cancellation values (`0`) unless the active filesystem provider implements `selectFileOpen` / `select_file_open`."
+        },
+        {
+            "question": "How does a browser host provide a real file picker?",
+            "answer": "Install a filesystem provider with a `selectFileOpen(request)` function. Return `null` or `false` for cancellation, a string path for one file, an array of string paths for multiple files, or an object such as `{ paths: ['/data/a.csv'], filterIndex: 1 }`."
+        },
+        {
+            "question": "Does `uigetfile` read the selected file?",
+            "answer": "No. It only returns the selected file name and directory. Use `fullfile(path, file)` with `readtable`, `fopen`, `load`, or another file-reading builtin to consume the file."
+        }
+    ],
+    "links": [
+        {
+            "label": "fullfile",
+            "url": "./fullfile"
+        },
+        {
+            "label": "readtable",
+            "url": "./readtable"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/io/repl_fs/uigetfile.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/io/repl_fs/uigetfile.rs"
+    },
+    "gpu_residency": "No. File-selection dialogs are host/UI operations and always execute outside GPU residency. The provider hook returns paths in the active filesystem namespace, so browser hosts that import user-selected files should map them into the mounted provider namespace before returning the path.",
+    "key": "uigetfile",
+    "slug": "uigetfile",
+    "aliases": [],
+    "categoryPath": [
+        "io",
+        "repl_fs"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=uigetfile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uigetfile.js","sourceRoot":"","sources":["../../../src/generated/builtins/uigetfile.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,WAAW;QACX,aAAa;QACb,aAAa;QACb,WAAW;QACX,YAAY;QACZ,IAAI;KACL;IACD,SAAS,EAAE,+EAA+E;IAC1F,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mIAAmI;KAC7I;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,yCAAyC;QACjD,aAAa,EAAE,4FAA4F;KAC5G;IACD,aAAa,EAAE,yRAAyR;IACxS,WAAW,EAAE;QACX,gDAAgD;QAChD,+JAA+J;QAC/J,kIAAkI;QAClI,gNAAgN;QAChN,mJAAmJ;QACnJ,mLAAmL;KACpL;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,+IAA+I;SACzJ;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,gIAAgI;SAC1I;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,2HAA2H;SACrI;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,0DAA0D;YACtE,QAAQ,EAAE,6IAA6I;SACxJ;QACD;YACE,UAAU,EAAE,qDAAqD;YACjE,QAAQ,EAAE,iQAAiQ;SAC5Q;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,8KAA8K;SACzL;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,eAAe,EAAE,iSAAiS;IAClT,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

@@ -0,0 +1,123 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "unwrap",
+    "category": "math/signal",
+    "keywords": [
+        "unwrap",
+        "phase",
+        "angle",
+        "signal processing",
+        "radians"
+    ],
+    "summary": "Correct phase-angle jumps by adding multiples of `2*pi`.",
+    "references": [
+        "title: \"MATLAB unwrap documentation\""
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are accepted through the active provider gather path. The host implementation performs stateful phase correction along the requested dimension."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::signal::unwrap::tests",
+        "integration": "runmat-vm basics hilbert_builtin_executes_for_fm_demod_shape"
+    },
+    "description": "`Q = unwrap(P)` adjusts phase angles in radians by adding integer multiples of `2*pi` whenever adjacent samples jump by more than the tolerance.",
+    "behaviors": [
+        "Accepts real numeric, logical, integer, vector, matrix, and N-D tensor inputs.",
+        "Operates along the first non-singleton dimension by default.",
+        "`unwrap(P, tol)` uses `max(tol, pi)` as the discontinuity threshold, matching MATLAB behavior for tolerances below `pi`.",
+        "`unwrap(P, [], dim)` keeps the default tolerance and unwraps along `dim`.",
+        "Preserves the input shape and numeric dtype metadata.",
+        "Complex inputs are rejected because `unwrap` expects real phase angles."
+    ],
+    "examples": [
+        {
+            "description": "Correct a wrapped phase vector",
+            "input": "p = [0 1 2 2-2*pi 3-2*pi];\nq = unwrap(p)",
+            "output": "q = [0 1 2 2 3]"
+        },
+        {
+            "description": "Use a custom tolerance",
+            "input": "p = [0 1 1-2*pi];\nq = unwrap(p, 10)",
+            "output": "q = [0 1 -5.2832]"
+        },
+        {
+            "description": "Unwrap across matrix rows",
+            "input": "P = [0 1 1-2*pi; 0 -1 -1+2*pi];\nQ = unwrap(P, [], 2)",
+            "output": "Q =\n     0     1     1\n     0    -1    -1"
+        },
+        {
+            "description": "Recover continuous phase from an analytic signal",
+            "input": "x = cos(0:0.1:10);\nz = hilbert(x);\nphase = unwrap(angle(z));"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What tolerance does `unwrap` use by default?",
+            "answer": "The default tolerance is `pi`. If you pass a tolerance below `pi`, RunMat uses `pi`, matching MATLAB's documented behavior."
+        },
+        {
+            "question": "Which dimension is unwrapped?",
+            "answer": "The first non-singleton dimension is used unless you pass `dim`."
+        },
+        {
+            "question": "Does `unwrap` change the shape?",
+            "answer": "No. The output has the same shape as the input."
+        },
+        {
+            "question": "Can I pass complex input?",
+            "answer": "No. Use `angle(z)` first to convert complex samples to real phase angles, then call `unwrap`."
+        }
+    ],
+    "links": [
+        {
+            "label": "angle",
+            "url": "./angle"
+        },
+        {
+            "label": "hilbert",
+            "url": "./hilbert"
+        },
+        {
+            "label": "diff",
+            "url": "./diff"
+        },
+        {
+            "label": "fft",
+            "url": "./fft"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/signal/unwrap.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/signal/unwrap.rs"
+    },
+    "gpu_residency": "`unwrap` accepts GPU tensors through the normal gather path. Because phase unwrapping is stateful along a dimension and currently materialized on the host, downstream GPU residency resumes only after an explicit `gpuArray` or another operation that uploads the result.",
+    "gpu_behavior": [
+        "GPU inputs are downloaded through the active provider with dtype normalization.",
+        "The host implementation performs MATLAB-compatible phase correction.",
+        "The output is a host tensor with the same shape as the input."
+    ],
+    "key": "unwrap",
+    "slug": "unwrap",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "signal"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=unwrap.js.map