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

package/dist/generated/builtins/eigs.js

@@ -0,0 +1,108 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "eigs",
+    "category": "math/linalg/factor",
+    "keywords": [
+        "eigs",
+        "eigenvalues",
+        "eigenvectors",
+        "sparse",
+        "linalg"
+    ],
+    "summary": "Compute selected eigenvalues and eigenvectors with MATLAB-compatible dense-fallback signatures.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "`eigs` is currently a host residency sink. gpuArray inputs are gathered before the exact dense fallback, and outputs are host tensors until a provider-side partial eigensolver lands."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::linalg::factor::eigs::tests"
+    },
+    "description": "`eigs(A)` returns a subset of eigenvalues. RunMat accepts dense, complex, logical, and small sparse or gpuArray compatibility inputs by materializing them on the host, computes the exact full eigendecomposition through the shared `eig` path, and selects the requested subset.",
+    "behaviors": [
+        "`eigs(A)` returns up to six eigenvalues with largest magnitude.",
+        "`eigs(A,k)` clamps `k` to `size(A,2)` when larger than the matrix order.",
+        "`eigs(A,k,sigma)` supports numeric `sigma` and the documented text selectors `largestabs`, `smallestabs`, `largestreal`, `smallestreal`, `bothendsreal`, `largestimag`, `smallestimag`, and `bothendsimag`, plus documented short aliases.",
+        "`eigs(A,B,...)` solves the generalized problem by reusing `eig(A,B)` and then selecting the requested subset.",
+        "Two outputs return selected right eigenvectors and a diagonal eigenvalue matrix. Three outputs append convergence flag `0` because the current exact fallback either succeeds fully or raises an error.",
+        "Options supplied as a struct or name-value pairs are validated for MATLAB-compatible field names, value shapes, subspace-dimension minimums, and generalized-problem sigma constraints. Iterative controls such as tolerance, maximum iterations, subspace dimension, start vector, display, and failure treatment do not change the exact fallback result.",
+        "Function-handle `Afun` forms are intentionally rejected with a deterministic unsupported-form error until RunMat has iterative operator eigensolver support.",
+        "Sparse inputs are materialized to dense host tensors for compatibility only. Very large sparse problems are not a completed high-performance `eigs` path and should be queued for a future sparse/provider implementation."
+    ],
+    "examples": [
+        {
+            "description": "Largest magnitude eigenvalues",
+            "input": "A = diag([1 8 -3 4]);\nd = eigs(A, 2)",
+            "output": "d = [8; 4]"
+        },
+        {
+            "description": "Smallest magnitude eigenvalues from sparse input",
+            "input": "S = sparse(diag([10 2 -4]));\nd = eigs(S, 2, 'smallestabs')",
+            "output": "d = [2; -4]"
+        },
+        {
+            "description": "Generalized eigenvalue subset",
+            "input": "A = [2 0; 0 9];\nB = [1 0; 0 3];\nd = eigs(A, B, 1, 'smallestreal')",
+            "output": "d = 2"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `eigs` use an iterative sparse algorithm?",
+            "answer": "Not yet. RunMat currently uses an exact dense fallback through `eig`, then applies `eigs` subset ordering. This is correct for small and medium compatibility cases but is not the final high-performance sparse path."
+        },
+        {
+            "question": "Which sigma selectors are supported?",
+            "answer": "RunMat supports numeric shifts plus `largestabs`, `smallestabs`, `largestreal`, `smallestreal`, `bothendsreal`, `largestimag`, `smallestimag`, `bothendsimag`, and the documented aliases such as `lm`, `sm`, `lr`, `sr`, `la`, `sa`, `be`, `li`, and `si`."
+        },
+        {
+            "question": "What does the convergence flag mean?",
+            "answer": "The third output is `0` for successful exact fallback results. If the shared eigendecomposition cannot complete, RunMat raises an error rather than returning nonconverged values."
+        }
+    ],
+    "links": [
+        {
+            "label": "eig",
+            "url": "./eig"
+        },
+        {
+            "label": "sparse",
+            "url": "./sparse"
+        },
+        {
+            "label": "gpuArray",
+            "url": "./gpuarray"
+        }
+    ],
+    "source": {
+        "label": "crates/runmat-runtime/src/builtins/math/linalg/factor/eigs.rs",
+        "url": "crates/runmat-runtime/src/builtins/math/linalg/factor/eigs.rs"
+    },
+    "gpu_behavior": [
+        "`eigs` currently gathers gpuArray inputs and returns host tensors because subset eigenvalue selection needs host-side ordering.",
+        "The builtin is explicitly marked `ResidencyPolicy::GatherImmediately` so the runtime does not imply a false GPU fast path.",
+        "A future provider implementation should add a true partial eigensolver hook in `runmat-accelerate` and parity tests against this exact fallback."
+    ],
+    "key": "eigs",
+    "slug": "eigs",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "linalg",
+        "factor"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=eigs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eigs.js","sourceRoot":"","sources":["../../../src/generated/builtins/eigs.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,MAAM;QACN,aAAa;QACb,cAAc;QACd,QAAQ;QACR,QAAQ;KACT;IACD,SAAS,EAAE,iGAAiG;IAC5G,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,wLAAwL;KAClM;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,6CAA6C;KACtD;IACD,aAAa,EAAE,qRAAqR;IACpS,WAAW,EAAE;QACX,iEAAiE;QACjE,0EAA0E;QAC1E,4OAA4O;QAC5O,+GAA+G;QAC/G,yMAAyM;QACzM,6VAA6V;QAC7V,8JAA8J;QAC9J,4NAA4N;KAC7N;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,6DAA6D;YACtE,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,qEAAqE;YAC9E,QAAQ,EAAE,OAAO;SAClB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,wNAAwN;SACnO;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,6PAA6P;SACxQ;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,oLAAoL;SAC/L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,+DAA+D;KACvE;IACD,cAAc,EAAE;QACd,iIAAiI;QACjI,4HAA4H;QAC5H,kJAAkJ;KACnJ;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;QACR,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/eluLayer.js

@@ -0,0 +1,40 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "eluLayer",
+    "category": "deep_learning",
+    "keywords": [
+        "eluLayer",
+        "deep learning",
+        "activation"
+    ],
+    "summary": "Create an ELU layer compatibility object.",
+    "description": "`eluLayer` creates metadata for ELU activation layers.",
+    "behaviors": [
+        "A leading numeric scalar sets `Alpha`; the default alpha is `1`.",
+        "`Name`, `Description`, and other common options are stored as properties."
+    ],
+    "examples": [
+        {
+            "description": "Create ELU",
+            "input": "layer = eluLayer(0.5, 'Name', 'elu1')",
+            "output": "`layer.Alpha` stores `0.5`."
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "layer = eluLayer\nlayer = eluLayer(alpha)\nlayer = eluLayer(___, Name, Value)",
+            "output": "Layer compatibility object."
+        }
+    },
+    "gpu_residency": "Layer construction is host metadata work and has no provider kernel.",
+    "key": "elulayer",
+    "slug": "elulayer",
+    "aliases": [],
+    "categoryPath": [
+        "deep_learning"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=eluLayer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eluLayer.js","sourceRoot":"","sources":["../../../src/generated/builtins/eluLayer.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,UAAU;QACV,eAAe;QACf,YAAY;KACb;IACD,SAAS,EAAE,2CAA2C;IACtD,aAAa,EAAE,wDAAwD;IACvE,WAAW,EAAE;QACX,kEAAkE;QAClE,2EAA2E;KAC5E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,YAAY;YAC3B,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,6BAA6B;SACxC;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,+EAA+E;YACxF,QAAQ,EAAE,6BAA6B;SACxC;KACF;IACD,eAAe,EAAE,sEAAsE;IACvF,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/encode.js

@@ -0,0 +1,117 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "encode",
+    "category": "strings/text_analytics",
+    "keywords": [
+        "encode",
+        "text analytics",
+        "bagOfWords",
+        "bagOfNgrams",
+        "count matrix"
+    ],
+    "summary": "Encode documents as sparse word or n-gram count matrices.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`encode` gathers provider inputs when needed, then builds and returns host sparse count matrices from host text-model metadata."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 4,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::strings::text_analytics::encode::tests",
+        "integration": null
+    },
+    "description": "`encode(bag, documents)` encodes `tokenizedDocument` input or a row word vector against a RunMat `bagOfWords` or `bagOfNgrams` compatibility object.",
+    "behaviors": [
+        "`bag` must be a scalar RunMat `bagOfWords` or `bagOfNgrams` object.",
+        "`documents` can be a RunMat `tokenizedDocument` object. A non-tokenized row word vector is accepted as one document.",
+        "The result is a RunMat sparse double matrix. By default, documents are rows and bag terms are columns.",
+        "`encode(___, 'DocumentsIn', 'rows')` returns one row per document. This is the default.",
+        "`encode(___, 'DocumentsIn', 'columns')` returns one column per document.",
+        "`encode(___, 'ForceCellOutput', true)` wraps the sparse result in a 1-by-1 cell array. This preserves the documented scalar-bag cell-output form without pretending object-array parity exists.",
+        "Words or n-grams not present in the bag model are ignored.",
+        "For `bagOfNgrams`, RunMat encodes the n-gram rows stored on the compatibility object and derives scan lengths from those rows.",
+        "Non-scalar bag object arrays and native MATLAB sparse model storage remain broader Text Analytics/runtime work."
+    ],
+    "examples": [
+        {
+            "description": "Encode Documents With A Bag Of Words",
+            "input": "bag = bagOfWords(tokenizedDocument([\"alpha beta\"; \"beta gamma\"]));\nnewDocuments = tokenizedDocument([\"beta beta delta\"; \"alpha gamma\"]);\ncounts = encode(bag, newDocuments)",
+            "output": "`counts` is a sparse 2-by-3 matrix using `bag.Vocabulary` as the column order."
+        },
+        {
+            "description": "Put Documents In Columns",
+            "input": "counts = encode(bag, [\"alpha\" \"beta\" \"alpha\"], \"DocumentsIn\", \"columns\")",
+            "output": "`counts` is a sparse matrix with one column because the word vector is one document."
+        },
+        {
+            "description": "Encode N-Grams",
+            "input": "bag = bagOfNgrams(tokenizedDocument(\"a b a\"), \"NgramLengths\", [1 2]);\ncounts = encode(bag, tokenizedDocument(\"a b a b\"))",
+            "output": "`counts` contains unigram and bigram counts for n-grams stored in `bag.Ngrams`."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `encode` return sparse output?",
+            "answer": "Yes. RunMat returns a host `SparseTensor` count matrix for both `bagOfWords` and `bagOfNgrams` inputs."
+        },
+        {
+            "question": "Does `ForceCellOutput` implement bag object arrays?",
+            "answer": "No. RunMat supports the scalar-bag cell wrapper form. MATLAB object-array identity and non-scalar bag arrays remain tracked by the Text Analytics umbrella issue."
+        },
+        {
+            "question": "Does `encode` execute on the GPU?",
+            "answer": "No. It gathers provider inputs when needed, uses host text metadata, and returns host sparse values."
+        }
+    ],
+    "links": [
+        {
+            "label": "bagOfWords",
+            "url": "./bagOfWords"
+        },
+        {
+            "label": "bagOfNgrams",
+            "url": "./bagOfNgrams"
+        },
+        {
+            "label": "tokenizedDocument",
+            "url": "./tokenizedDocument"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "counts = encode(bag, documents)\ncounts = encode(bag, words)\ncounts = encode(___, \"DocumentsIn\", \"rows\")\ncounts = encode(___, \"DocumentsIn\", \"columns\")\nC = encode(___, \"ForceCellOutput\", true)",
+            "output": "`counts` is a sparse count matrix. `C` is a 1-by-1 cell containing that sparse matrix."
+        },
+        "points": [
+            "`bag` must be a scalar RunMat `bagOfWords` or `bagOfNgrams` object.",
+            "`documents` must be a RunMat `tokenizedDocument` object.",
+            "Non-tokenized input must be a row word vector and is treated as one document.",
+            "`DocumentsIn` must be `'rows'` or `'columns'`.",
+            "`ForceCellOutput` must be a logical scalar."
+        ]
+    },
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/strings/text_analytics/encode.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/text_analytics/encode.rs"
+    },
+    "gpu_residency": "`encode` currently gathers provider inputs and returns host sparse output because RunMat sparse values are host-resident.",
+    "key": "encode",
+    "slug": "encode",
+    "aliases": [],
+    "categoryPath": [
+        "strings",
+        "text_analytics"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=encode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encode.js","sourceRoot":"","sources":["../../../src/generated/builtins/encode.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,wBAAwB;IACpC,UAAU,EAAE;QACV,QAAQ;QACR,gBAAgB;QAChB,YAAY;QACZ,aAAa;QACb,cAAc;KACf;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,iIAAiI;KAC3I;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,kDAAkD;QAC1D,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,sJAAsJ;IACrK,WAAW,EAAE;QACX,qEAAqE;QACrE,sHAAsH;QACtH,wGAAwG;QACxG,yFAAyF;QACzF,0EAA0E;QAC1E,iMAAiM;QACjM,4DAA4D;QAC5D,gIAAgI;QAChI,iHAAiH;KAClH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,uLAAuL;YAChM,QAAQ,EAAE,gFAAgF;SAC3F;QACD;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,oFAAoF;YAC7F,QAAQ,EAAE,sFAAsF;SACjG;QACD;YACE,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,iIAAiI;YAC1I,QAAQ,EAAE,iFAAiF;SAC5F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,wGAAwG;SACnH;QACD;YACE,UAAU,EAAE,qDAAqD;YACjE,QAAQ,EAAE,mKAAmK;SAC9K;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,sGAAsG;SACjH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,qBAAqB;SAC7B;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,+MAA+M;YACxN,QAAQ,EAAE,wFAAwF;SACnG;QACD,QAAQ,EAAE;YACR,qEAAqE;YACrE,0DAA0D;YAC1D,+EAA+E;YAC/E,gDAAgD;YAChD,6CAA6C;SAC9C;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,uEAAuE;QAChF,KAAK,EAAE,oHAAoH;KAC5H;IACD,eAAe,EAAE,2HAA2H;IAC5I,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,gBAAgB;KACjB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/erasePunctuation.js

@@ -0,0 +1,115 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "erasePunctuation",
+    "category": "strings/transform",
+    "keywords": [
+        "erasePunctuation",
+        "punctuation",
+        "symbols",
+        "text analytics",
+        "string"
+    ],
+    "summary": "Remove Unicode punctuation and symbol characters from text and tokenized documents.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Text values are host-resident. GPU-resident wrapper inputs are gathered before evaluating this string transform."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::strings::transform::compat::tests::splitlines_reverse_deblank_and_matches_work",
+        "integration": null
+    },
+    "description": "`erasePunctuation(text)` removes characters in Unicode punctuation and symbol categories from string, character, and cell text inputs while preserving the input container shape and type. `erasePunctuation(documents)` filters punctuation and symbol tokens from RunMat `tokenizedDocument` compatibility objects.",
+    "behaviors": [
+        "String scalars and string arrays return string values with punctuation and symbol characters removed from each nonmissing element.",
+        "Character vectors and character arrays return character arrays; rows are padded after punctuation removal when needed to preserve rectangular char storage.",
+        "Cell arrays are processed recursively for string and character text elements and retain the original cell shape.",
+        "Missing string elements are preserved.",
+        "`erasePunctuation(documents)` removes punctuation and symbol characters from tokens with derived type `punctuation` or `other` and removes tokens that become empty.",
+        "`erasePunctuation(documents,'TokenTypes',types)` removes punctuation and symbols only from the specified derived token types. RunMat uses the same lightweight token-type classifier exposed by `tokenDetails` and `addTypeDetails`.",
+        "For tokenized documents, URLs, email addresses, hashtags, mentions, and emoticons are preserved by default."
+    ],
+    "examples": [
+        {
+            "description": "Erase Punctuation From A String",
+            "input": "erasePunctuation(\"it's one and/or two.\")",
+            "output": "\"its one andor two\""
+        },
+        {
+            "description": "Erase Punctuation And Symbols From A Character Vector",
+            "input": "erasePunctuation('cost: $5.00!')",
+            "output": "'cost 500'"
+        },
+        {
+            "description": "Preserve Cell Array Shape",
+            "input": "erasePunctuation({'alpha,beta!','C++ and C#'})",
+            "output": "{'alphabeta','C and C'}"
+        },
+        {
+            "description": "Erase Punctuation From Tokenized Documents",
+            "input": "documents = tokenizedDocument(\"An example: visit https://example.com.\");\nnewDocuments = erasePunctuation(documents)",
+            "output": "`newDocuments` contains `An example visit https://example.com`."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `erasePunctuation` remove spaces?",
+            "answer": "No. Whitespace is not in a Unicode punctuation or symbol category, so spaces are preserved."
+        },
+        {
+            "question": "Does this implement tokenizedDocument token-type filtering?",
+            "answer": "Yes for RunMat's lightweight `tokenizedDocument` objects. It supports default `punctuation`/`other` filtering and explicit `TokenTypes`; full custom token-detail tables and linguistic detail columns remain tracked separately."
+        }
+    ],
+    "links": [
+        {
+            "label": "eraseURLs",
+            "url": "./eraseURLs"
+        },
+        {
+            "label": "string",
+            "url": "./string"
+        },
+        {
+            "label": "char",
+            "url": "./char"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "newText = erasePunctuation(text)\nnewDocuments = erasePunctuation(documents)\nnewDocuments = erasePunctuation(documents,'TokenTypes',types)",
+            "output": "`newText` has the same text container shape and type as `text`. `newDocuments` is a tokenizedDocument compatibility object."
+        },
+        "points": [
+            "`text` may be a string scalar, string array, character vector, character array, or cell array containing text values.",
+            "`documents` must be a RunMat `tokenizedDocument` object.",
+            "`types` may be a string scalar/vector, character vector, or cell array of character vectors naming derived token types.",
+            "Punctuation and symbol removal follows Unicode punctuation (`P*`) and symbol (`S*`) categories."
+        ]
+    },
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/strings/transform/compat.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/transform/compat.rs"
+    },
+    "gpu_residency": "`erasePunctuation` operates on host text and has no provider kernel.",
+    "key": "erasepunctuation",
+    "slug": "erasepunctuation",
+    "aliases": [],
+    "categoryPath": [
+        "strings",
+        "transform"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=erasePunctuation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"erasePunctuation.js","sourceRoot":"","sources":["../../../src/generated/builtins/erasePunctuation.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,kBAAkB;IAC3B,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,kBAAkB;QAClB,aAAa;QACb,SAAS;QACT,gBAAgB;QAChB,QAAQ;KACT;IACD,SAAS,EAAE,qFAAqF;IAChG,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,kHAAkH;KAC5H;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,0FAA0F;QAClG,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,uTAAuT;IACtU,WAAW,EAAE;QACX,oIAAoI;QACpI,6JAA6J;QAC7J,kHAAkH;QAClH,wCAAwC;QACxC,sKAAsK;QACtK,sOAAsO;QACtO,6GAA6G;KAC9G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,4CAA4C;YACrD,QAAQ,EAAE,uBAAuB;SAClC;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,kCAAkC;YAC3C,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,gDAAgD;YACzD,QAAQ,EAAE,yBAAyB;SACpC;QACD;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,wHAAwH;YACjI,QAAQ,EAAE,iEAAiE;SAC5E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,6FAA6F;SACxG;QACD;YACE,UAAU,EAAE,6DAA6D;YACzE,QAAQ,EAAE,mOAAmO;SAC9O;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,6IAA6I;YACtJ,QAAQ,EAAE,6HAA6H;SACxI;QACD,QAAQ,EAAE;YACR,uHAAuH;YACvH,0DAA0D;YAC1D,yHAAyH;YACzH,iGAAiG;SAClG;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,eAAe,EAAE,sEAAsE;IACvF,KAAK,EAAE,kBAAkB;IACzB,MAAM,EAAE,kBAAkB;IAC1B,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,WAAW;KACZ;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/eraseURLs.js

@@ -0,0 +1,87 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "eraseURLs",
+    "category": "strings/transform",
+    "keywords": [
+        "eraseURLs",
+        "strings",
+        "transform",
+        "matlab",
+        "compatibility"
+    ],
+    "summary": "Remove URL substrings from text.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "No GPU kernel is registered for this compatibility builtin; GPU-resident inputs are gathered to host memory before evaluation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": null,
+        "constants": "not applicable",
+        "notes": "Not eligible for fusion; this builtin materializes host text or logical results."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::strings::transform::compat::tests",
+        "integration": null
+    },
+    "description": "s = eraseURLs(text) - Remove URL substrings from text.",
+    "signatures": [
+        {
+            "label": "s = eraseURLs(text)",
+            "inputs": [
+                {
+                    "name": "text",
+                    "ty": "Any",
+                    "arity": "Required",
+                    "default": null,
+                    "description": "Input text."
+                }
+            ],
+            "outputs": [
+                {
+                    "name": "out",
+                    "ty": "Any",
+                    "arity": "Required",
+                    "default": null,
+                    "description": "Output value."
+                }
+            ]
+        }
+    ],
+    "behaviors": [
+        "Remove URL substrings from text."
+    ],
+    "examples": [
+        "eraseURLs(\"see https://example.com now\") removes the URL substring."
+    ],
+    "faqs": [],
+    "links": [
+        {
+            "label": "string",
+            "url": "./string"
+        },
+        {
+            "label": "char",
+            "url": "./char"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/strings/transform/compat.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/transform/compat.rs"
+    },
+    "key": "eraseurls",
+    "slug": "eraseurls",
+    "aliases": [],
+    "categoryPath": [
+        "strings",
+        "transform"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=eraseURLs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eraseURLs.js","sourceRoot":"","sources":["../../../src/generated/builtins/eraseURLs.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,WAAW;QACX,SAAS;QACT,WAAW;QACX,QAAQ;QACR,eAAe;KAChB;IACD,SAAS,EAAE,kCAAkC;IAC7C,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gIAAgI;KAC1I;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,kFAAkF;KAC5F;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,6CAA6C;QACrD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,wDAAwD;IACvE,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,qBAAqB;YAC9B,QAAQ,EAAE;gBACR;oBACE,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,aAAa;iBAC7B;aACF;YACD,SAAS,EAAE;gBACT;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,eAAe;iBAC/B;aACF;SACF;KACF;IACD,WAAW,EAAE;QACX,kCAAkC;KACnC;IACD,UAAU,EAAE;QACV,uEAAuE;KACxE;IACD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,WAAW;KACZ;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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