runmat 0.6.1 → 0.6.2-dev.1

package/dist/generated/builtins/erasePunctuation.js

@@ -6,17 +6,17 @@ const builtinDoc = {
     "keywords": [
         "erasePunctuation",
         "punctuation",
-        "symbols",
-        "text analytics",
-        "string"
+        "Unicode",
+        "tokenizedDocument",
+        "text analytics"
     ],
-    "summary": "Remove Unicode punctuation and symbol characters from text and tokenized documents.",
+    "summary": "Erase Unicode punctuation and symbol characters from text or selected token types in 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."
+        "notes": "The documented inputs are host text and tokenizedDocument values. Resident numeric inputs are invalid and reject before provider access."
     },
     "fusion": {
         "elementwise": false,
@@ -26,83 +26,71 @@ const builtinDoc = {
     },
     "requires_feature": null,
     "tested": {
-        "unit": "builtins::strings::transform::compat::tests::splitlines_reverse_deblank_and_matches_work",
+        "unit": "builtins::strings::transform::compat::tests and builtins::strings::text_analytics::documents::tests",
         "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.",
+    "description": "`erasePunctuation` removes characters in the Unicode punctuation (`P*`) and symbol (`S*`) categories from documented text containers. For tokenized documents, it removes punctuation only from the selected token types and removes tokens that become empty.",
     "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."
+        "`newStr = erasePunctuation(str)` accepts a string array, character vector, or cell array of character vectors and returns the same documented container type.",
+        "`newDocuments = erasePunctuation(documents)` processes token types `punctuation` and `other` by default, preserving complex tokens such as web addresses and email addresses.",
+        "`newDocuments = erasePunctuation(documents,'TokenTypes',types)` processes only the supplied built-in or custom token types.",
+        "RunMat preserves document shape and explicit token type details in its current scalar compatibility-object representation.",
+        "All integer and logical values are invalid in text, document, option-name, and TokenTypes roles; no implicit numeric-to-text conversion occurs.",
+        "RunMat can process character matrices row-wise and nested or non-cellstr text cells, but those containers are independently gated RunMat-only extensions beyond the documented character-vector and cellstr surface."
     ],
     "examples": [
         {
-            "description": "Erase Punctuation From A String",
-            "input": "erasePunctuation(\"it's one and/or two.\")",
-            "output": "\"its one andor two\""
+            "description": "Erase punctuation from text",
+            "input": "newStr = erasePunctuation(\"it's one and/or two.\")",
+            "output": "newStr = \"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`."
+            "description": "Preserve complex document tokens by default",
+            "input": "documents = tokenizedDocument(\"Visit https://example.com.\");\nnewDocuments = erasePunctuation(documents)",
+            "output": "The web-address token remains intact while the sentence punctuation token is removed."
         }
     ],
     "faqs": [
         {
-            "question": "Does `erasePunctuation` remove spaces?",
-            "answer": "No. Whitespace is not in a Unicode punctuation or symbol category, so spaces are preserved."
+            "question": "Does erasePunctuation run on a GPU?",
+            "answer": "No. It is host text processing and has no provider kernel. Resident numeric values are invalid text and reject without gathering."
         },
         {
-            "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."
+            "question": "Are tokenizedDocument arrays represented exactly?",
+            "answer": "RunMat currently uses one scalar compatibility object carrying document cells and Shape metadata. First-class object-array identity remains a general runtime infrastructure gap."
         }
     ],
     "links": [
         {
-            "label": "eraseURLs",
-            "url": "./eraseURLs"
+            "label": "MathWorks erasePunctuation documentation",
+            "url": "https://www.mathworks.com/help/textanalytics/ref/tokenizeddocument.erasepunctuation.html"
         },
         {
-            "label": "string",
-            "url": "./string"
+            "label": "eraseURLs",
+            "url": "./eraseURLs"
         },
         {
-            "label": "char",
-            "url": "./char"
+            "label": "tokenizedDocument",
+            "url": "./tokenizedDocument"
         }
     ],
     "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."
+            "description": "Documented forms",
+            "input": "newStr = erasePunctuation(str)\nnewDocuments = erasePunctuation(documents)\nnewDocuments = erasePunctuation(documents,'TokenTypes',types)",
+            "output": "The result preserves the documented text container type or returns tokenized documents."
         },
         "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."
+            "`str` is a string array, character vector, or cell array of character vectors.",
+            "`documents` is a tokenizedDocument array.",
+            "`types` is a character vector, string array, or cell array of character vectors containing token type names."
         ]
     },
     "source": {
-        "label": "`crates/runmat-runtime/src/builtins/strings/transform/compat.rs`",
+        "label": "`crates/runmat-runtime/src/builtins/strings/transform/compat.rs` and `crates/runmat-runtime/src/builtins/strings/text_analytics/documents.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.",
+    "gpu_residency": "Host-only text processing; no provider hook or resident text representation.",
     "key": "erasepunctuation",
     "slug": "erasepunctuation",
     "aliases": [],

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

@@ -1 +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"}
+{"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,mBAAmB;QACnB,gBAAgB;KACjB;IACD,SAAS,EAAE,2GAA2G;IACtH,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0IAA0I;KACpJ;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,qGAAqG;QAC7G,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,gQAAgQ;IAC/Q,WAAW,EAAE;QACX,+JAA+J;QAC/J,+KAA+K;QAC/K,6HAA6H;QAC7H,4HAA4H;QAC5H,iJAAiJ;QACjJ,sNAAsN;KACvN;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,qDAAqD;YAC9D,QAAQ,EAAE,gCAAgC;SAC3C;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,4GAA4G;YACrH,QAAQ,EAAE,uFAAuF;SAClG;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,mIAAmI;SAC9I;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,mLAAmL;SAC9L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,0CAA0C;YACnD,KAAK,EAAE,0FAA0F;SAClG;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,qBAAqB;SAC7B;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,kBAAkB;YACjC,OAAO,EAAE,2IAA2I;YACpJ,QAAQ,EAAE,yFAAyF;SACpG;QACD,QAAQ,EAAE;YACR,gFAAgF;YAChF,2CAA2C;YAC3C,8GAA8G;SAC/G;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+IAA+I;QACxJ,KAAK,EAAE,+GAA+G;KACvH;IACD,eAAe,EAAE,8EAA8E;IAC/F,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.map

@@ -1 +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"}
+{"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,UAkGjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/eraseURLs.js

@@ -5,76 +5,92 @@ const builtinDoc = {
     "category": "strings/transform",
     "keywords": [
         "eraseURLs",
-        "strings",
-        "transform",
-        "matlab",
-        "compatibility"
+        "URL",
+        "HTTP",
+        "HTTPS",
+        "tokenizedDocument"
     ],
-    "summary": "Remove URL substrings from text.",
+    "summary": "Erase HTTP and HTTPS URLs from text and web-address tokens from tokenized documents.",
     "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."
+        "notes": "The documented inputs are host text and tokenizedDocument values. Resident numeric values reject before provider access."
     },
     "fusion": {
         "elementwise": false,
         "reduction": false,
-        "max_inputs": null,
-        "constants": "not applicable",
-        "notes": "Not eligible for fusion; this builtin materializes host text or logical results."
+        "max_inputs": 1,
+        "constants": "inline"
     },
     "requires_feature": null,
     "tested": {
-        "unit": "builtins::strings::transform::compat::tests",
+        "unit": "builtins::strings::transform::compat::tests and builtins::strings::text_analytics::documents::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."
-                }
-            ]
-        }
-    ],
+    "description": "`eraseURLs` erases HTTP and HTTPS URLs from documented text containers. Starting with the compatibility target, it also accepts tokenizedDocument input and removes tokens whose type is `web-address`.",
     "behaviors": [
-        "Remove URL substrings from text."
+        "`newStr = eraseURLs(str)` accepts a string array, character vector, or cell array of character vectors and returns the same documented container type.",
+        "`newDocuments = eraseURLs(documents)` removes web-address tokens and preserves the document shape and remaining explicit token type metadata supported by RunMat's object model.",
+        "URL matching is case-insensitive for the HTTP and HTTPS schemes.",
+        "All integer and logical inputs are invalid; no numeric-to-text conversion occurs.",
+        "Multirow character matrices and cells containing strings or nested cells are broader RunMat-only forms with independent compatibility gates.",
+        "RunMat has no resident text storage or eraseURLs provider kernel, so invalid resident numeric values reject without gathering."
     ],
     "examples": [
-        "eraseURLs(\"see https://example.com now\") removes the URL substring."
+        {
+            "description": "Erase a URL from text",
+            "input": "str = \"For more information, see https://www.mathworks.com\";\nnewStr = eraseURLs(str)",
+            "output": "newStr = \"For more information, see \""
+        },
+        {
+            "description": "Erase web-address tokens from documents",
+            "input": "documents = tokenizedDocument(\"Visit https://example.com now\");\nnewDocuments = eraseURLs(documents)",
+            "output": "The resulting document contains the tokens `Visit` and `now`."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does eraseURLs accept tokenizedDocument input?",
+            "answer": "Yes. The compatibility target documents tokenizedDocument input, and RunMat removes tokens whose type is `web-address`."
+        },
+        {
+            "question": "Does eraseURLs remove a bare www address?",
+            "answer": "The documented surface specifies HTTP and HTTPS URLs. RunMat does not advertise bare `www.` matching as MATLAB-compatible behavior."
+        }
     ],
-    "faqs": [],
     "links": [
         {
-            "label": "string",
-            "url": "./string"
+            "label": "MathWorks eraseURLs documentation",
+            "url": "https://www.mathworks.com/help/textanalytics/ref/eraseurls.html"
         },
         {
-            "label": "char",
-            "url": "./char"
+            "label": "erasePunctuation",
+            "url": "./erasePunctuation"
+        },
+        {
+            "label": "tokenizedDocument",
+            "url": "./tokenizedDocument"
         }
     ],
+    "syntax": {
+        "example": {
+            "description": "Documented forms",
+            "input": "newStr = eraseURLs(str)\nnewDocuments = eraseURLs(documents)",
+            "output": "The result preserves the documented text container type or returns tokenized documents."
+        },
+        "points": [
+            "`str` is a string array, character vector, or cell array of character vectors.",
+            "`documents` is a tokenizedDocument array.",
+            "The tokenizedDocument form removes tokens classified as `web-address`."
+        ]
+    },
     "source": {
-        "label": "`crates/runmat-runtime/src/builtins/strings/transform/compat.rs`",
+        "label": "`crates/runmat-runtime/src/builtins/strings/transform/compat.rs` and `crates/runmat-runtime/src/builtins/strings/text_analytics/documents.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/transform/compat.rs"
     },
+    "gpu_residency": "Host-only text processing; no provider hook or resident text representation.",
     "key": "eraseurls",
     "slug": "eraseurls",
     "aliases": [],

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

@@ -1 +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"}
+{"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,KAAK;QACL,MAAM;QACN,OAAO;QACP,mBAAmB;KACpB;IACD,SAAS,EAAE,sFAAsF;IACjG,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0HAA0H;KACpI;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,qGAAqG;QAC7G,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,yMAAyM;IACxN,WAAW,EAAE;QACX,wJAAwJ;QACxJ,kLAAkL;QAClL,kEAAkE;QAClE,mFAAmF;QACnF,8IAA8I;QAC9I,gIAAgI;KACjI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,yFAAyF;YAClG,QAAQ,EAAE,yCAAyC;SACpD;QACD;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,wGAAwG;YACjH,QAAQ,EAAE,+DAA+D;SAC1E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,yHAAyH;SACpI;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,qIAAqI;SAChJ;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,mCAAmC;YAC5C,KAAK,EAAE,iEAAiE;SACzE;QACD;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,oBAAoB;SAC5B;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,qBAAqB;SAC7B;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,kBAAkB;YACjC,OAAO,EAAE,8DAA8D;YACvE,QAAQ,EAAE,yFAAyF;SACpG;QACD,QAAQ,EAAE;YACR,gFAAgF;YAChF,2CAA2C;YAC3C,wEAAwE;SACzE;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+IAA+I;QACxJ,KAAK,EAAE,+GAA+G;KACvH;IACD,eAAe,EAAE,8EAA8E;IAC/F,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.map

@@ -1 +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"}
+{"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,UAiHjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/erf.js

@@ -19,7 +19,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "matlab",
-        "notes": "Uses the provider unary_erf hook for real GPU tensors and falls back to host evaluation when the hook is unavailable."
+        "notes": "Uses the provider unary_erf hook for real GPU tensors and restores host fallback results to the input's owning provider when the hook is unavailable."
     },
     "fusion": {
         "elementwise": false,
@@ -36,9 +36,8 @@ const builtinDoc = {
     "behaviors": [
         "`erf(X)` applies the error function element-by-element while preserving the input tensor shape.",
         "Double inputs return double results; single tensors preserve single dtype metadata with single-rounded output values.",
-        "Scalar integer, logical, and character inputs are promoted through RunMat's ordinary numeric coercion path for compatibility with existing elementwise builtins.",
-        "Complex, string, and sparse inputs produce stable `RunMat:erf:InvalidInput` errors.",
-        "Real GPU tensors stay on device when the provider implements `unary_erf`; otherwise RunMat gathers the tensor, evaluates on the host, and returns a host value with the computed results."
+        "Integer, logical, character, complex, string, sparse, table, and timetable inputs are not part of the documented surface and produce stable `RunMat:erf:InvalidInput` errors.",
+        "Real GPU tensors stay on the input's owning provider after direct execution or host fallback; malformed provider results are rejected rather than admitted as resident values."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"erf.js","sourceRoot":"","sources":["../../../src/generated/builtins/erf.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,KAAK;QACL,gBAAgB;QAChB,kBAAkB;QAClB,aAAa;QACb,KAAK;KACN;IACD,SAAS,EAAE,kEAAkE;IAC7E,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,uHAAuH;KACjI;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,qEAAqE;KACrF;IACD,aAAa,EAAE,6OAA6O;IAC5P,WAAW,EAAE;QACX,iGAAiG;QACjG,uHAAuH;QACvH,kKAAkK;QAClK,qFAAqF;QACrF,2LAA2L;KAC5L;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,YAAY;YACrB,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,+BAA+B;YACxC,QAAQ,EAAE,+BAA+B;SAC1C;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yCAAyC;YAClD,QAAQ,EAAE,sCAAsC;SACjD;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,8DAA8D;YACvE,QAAQ,EAAE,6BAA6B;SACxC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,iLAAiL;SAC5L;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,8JAA8J;SACzK;QACD;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,gJAAgJ;SAC3J;KACF;IACD,SAAS,EAAE;QACT;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,8DAA8D;YACvE,KAAK,EAAE,2GAA2G;SACnH;KACF;IACD,eAAe,EAAE,gOAAgO;IACjP,sBAAsB,EAAE;QACtB,oEAAoE;QACpE,oJAAoJ;QACpJ,iGAAiG;KAClG;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,aAAa;KACd;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"erf.js","sourceRoot":"","sources":["../../../src/generated/builtins/erf.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,KAAK;QACL,gBAAgB;QAChB,kBAAkB;QAClB,aAAa;QACb,KAAK;KACN;IACD,SAAS,EAAE,kEAAkE;IAC7E,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,uJAAuJ;KACjK;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,qEAAqE;KACrF;IACD,aAAa,EAAE,6OAA6O;IAC5P,WAAW,EAAE;QACX,iGAAiG;QACjG,uHAAuH;QACvH,+KAA+K;QAC/K,gLAAgL;KACjL;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,YAAY;YACrB,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,+BAA+B;YACxC,QAAQ,EAAE,+BAA+B;SAC1C;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yCAAyC;YAClD,QAAQ,EAAE,sCAAsC;SACjD;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,8DAA8D;YACvE,QAAQ,EAAE,6BAA6B;SACxC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,iLAAiL;SAC5L;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,8JAA8J;SACzK;QACD;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,gJAAgJ;SAC3J;KACF;IACD,SAAS,EAAE;QACT;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,8DAA8D;YACvE,KAAK,EAAE,2GAA2G;SACnH;KACF;IACD,eAAe,EAAE,gOAAgO;IACjP,sBAAsB,EAAE;QACtB,oEAAoE;QACpE,oJAAoJ;QACpJ,iGAAiG;KAClG;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,aAAa;KACd;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/erfcinv.js

@@ -12,7 +12,7 @@ const builtinDoc = {
     ],
     "summary": "Compute inverse complementary error-function values.",
     "gpu_support": {
-        "elementwise": false,
+        "elementwise": true,
         "reduction": false,
         "precisions": [
             "f32",

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

@@ -1 +1 @@
-{"version":3,"file":"erfcinv.js","sourceRoot":"","sources":["../../../src/generated/builtins/erfcinv.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,SAAS;QACT,sCAAsC;QACtC,SAAS;QACT,aAAa;QACb,KAAK;KACN;IACD,SAAS,EAAE,sDAAsD;IACjE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,gJAAgJ;KAC1J;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;QACrD,KAAK,EAAE,wEAAwE;KAChF;IACD,aAAa,EAAE,4HAA4H;IAC3I,WAAW,EAAE;QACX,sDAAsD;QACtD,wFAAwF;QACxF,uCAAuC;QACvC,sCAAsC;QACtC,gFAAgF;KACjF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,4CAA4C;YACrD,QAAQ,EAAE,gDAAgD;SAC3D;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE,cAAc;SACzB;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,oDAAoD;YAC7D,QAAQ,EAAE,6BAA6B;SACxC;QACD;YACE,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,8DAA8D;SACzE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,mIAAmI;SAC9I;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,kJAAkJ;SAC7J;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,2LAA2L;SACtM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,eAAe,EAAE,0MAA0M;IAC3N,cAAc,EAAE;QACd,8EAA8E;QAC9E,qFAAqF;KACtF;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,aAAa;KACd;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"erfcinv.js","sourceRoot":"","sources":["../../../src/generated/builtins/erfcinv.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,SAAS;QACT,sCAAsC;QACtC,SAAS;QACT,aAAa;QACb,KAAK;KACN;IACD,SAAS,EAAE,sDAAsD;IACjE,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,gJAAgJ;KAC1J;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;QACrD,KAAK,EAAE,wEAAwE;KAChF;IACD,aAAa,EAAE,4HAA4H;IAC3I,WAAW,EAAE;QACX,sDAAsD;QACtD,wFAAwF;QACxF,uCAAuC;QACvC,sCAAsC;QACtC,gFAAgF;KACjF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,4CAA4C;YACrD,QAAQ,EAAE,gDAAgD;SAC3D;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE,cAAc;SACzB;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,oDAAoD;YAC7D,QAAQ,EAAE,6BAA6B;SACxC;QACD;YACE,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,8DAA8D;SACzE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,mIAAmI;SAC9I;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,kJAAkJ;SAC7J;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,2LAA2L;SACtM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,eAAe,EAAE,0MAA0M;IAC3N,cAAc,EAAE;QACd,8EAA8E;QAC9E,qFAAqF;KACtF;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,aAAa;KACd;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/error.js

@@ -6,22 +6,22 @@ const builtinDoc = {
     "keywords": [
         "error",
         "exception",
-        "throw",
-        "diagnostics",
-        "message"
+        "identifier",
+        "formatting",
+        "try catch"
     ],
-    "summary": "Throw exceptions with identifiers and formatted messages in MATLAB and RunMat.",
+    "summary": "Throw an error with optional identifier and formatted message values.",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Always executed on the host; GPU tensors are gathered only when they appear in formatted arguments."
+        "notes": "Formatting values may be GPU arrays as documented by MathWorks. RunMat validates host message and identifier text first, gathers formatting data, formats on the host, and then throws."
     },
     "fusion": {
         "elementwise": false,
         "reduction": false,
-        "max_inputs": 0,
+        "max_inputs": null,
         "constants": "inline"
     },
     "requires_feature": null,
@@ -29,90 +29,75 @@ const builtinDoc = {
         "unit": "builtins::diagnostics::error::tests",
         "integration": null
     },
-    "description": "`error` throws an exception immediately, unwinding the current execution frame to the nearest `catch` (or aborting if none exists). Identifier, formatting, and exception-object behavior follow MATLAB semantics.",
+    "description": "`error` constructs a diagnostic message and transfers control to the nearest compatible catch boundary. A one-input message is literal; multi-input forms decode documented escapes and apply sprintf-style formatting before throwing.",
     "behaviors": [
-        "`error(message)` throws using the default identifier `RunMat:error`.",
-        "`error(id, message)` uses a custom identifier. Identifiers are normalised to `RunMat:*` when they do not already contain a namespace.",
-        "`error(fmt, arg1, ...)` formats the message with MATLAB's `sprintf` rules before throwing.",
-        "`error(id, fmt, arg1, ...)` combines both a custom identifier and formatted message text.",
-        "`error(MException_obj)` rethrows an existing exception without altering its identifier or message.",
-        "`error(struct('identifier', id, 'message', msg))` honours the legacy structure form.",
-        "Invalid invocations (missing message, extra arguments after an `MException`, malformed structs, etc.) themselves raise `RunMat:error` diagnostics so the caller can correct usage.\n\nThe thrown exception is observed in MATLAB-compatible `try`/`catch` constructs or by the embedding runtime, which converts the string back into an `MException` object."
+        "`error(msg)` throws the literal text scalar without converting escape or format sequences.",
+        "`error(msg,A)` and `error(errID,___)` decode escape sequences, format replacement values, and then throw.",
+        "Documented error identifiers use colon-separated fields that each begin with a letter and otherwise contain only letters, digits, or underscores.",
+        "All eight integer classes are documented numeric formatting values. RunMat keeps typed integers authoritative through integer conversion specifiers, including `uint64` values above binary64's exact range.",
+        "If every supplied input is an empty array, the call is a no-op and does not throw.",
+        "`error(MException)`, unqualified identifier normalization, and the `messageid` or `msg` structure aliases are independent RunMat-only extensions and reject in MATLAB compatibility mode.",
+        "The documented matlab.lang.correction object families are not yet representable in RunMat and currently raise an explicit unsupported diagnostic.",
+        "An errorStruct can use message and identifier fields independently. Explicit errorStruct stack reconstruction is deferred because RuntimeError does not yet accept MATLAB stack structures."
     ],
     "examples": [
         {
-            "description": "Throwing an error with a simple message",
-            "input": "try\n    error(\"Computation failed.\");\ncatch err\n    fprintf(\"%s -> %s\\n\", err.identifier, err.message);\nend"
+            "description": "Throw a formatted error with an identifier",
+            "input": "error('MyComponent:incorrectType','Input must be a char, not a %s.',class(x))",
+            "output": "Throws an exception with identifier `MyComponent:incorrectType`."
         },
         {
-            "description": "Throwing an error with a custom identifier",
-            "input": "try\n    error(\"runmat:examples:invalidState\", \"State vector is empty.\");\ncatch err\n    fprintf(\"%s\\n\", err.identifier);\nend"
-        },
-        {
-            "description": "Formatting values inside the error message",
-            "input": "value = 42;\ntry\n    error(\"RunMat:demo:badValue\", \"Value %d is outside [%d, %d].\", value, 0, 10);\ncatch err\n    disp(err.message);\nend"
-        },
-        {
-            "description": "Rethrowing an existing MException",
-            "input": "try\n    try\n        error(\"RunMat:inner:failure\", \"Inner failure.\");\n    catch inner\n        error(inner); % propagate with original identifier/message\n    end\ncatch err\n    fprintf(\"%s\\n\", err.identifier);\nend"
-        },
-        {
-            "description": "Using a legacy message struct",
-            "input": "S.identifier = \"toolbox:demo:badInput\";\nS.message = \"Inputs must be positive integers.\";\ntry\n    error(S);\ncatch err\n    fprintf(\"%s\\n\", err.identifier);\nend"
+            "description": "Format an exact typed integer",
+            "input": "error('Value is %u',uint64(18446744073709551615))",
+            "output": "The integer conversion uses authoritative uint64 storage before the diagnostic is thrown."
         }
     ],
     "faqs": [
         {
-            "question": "How do I choose a custom identifier?",
-            "answer": "Use `component:mnemonic` style strings such as `\"RunMat:io:fileNotFound\"` or `\"runmat:tools:badInput\"`. If you omit a namespace (`:`), RunMat prefixes the identifier with `RunMat:` automatically."
+            "question": "Does error execute on the GPU?",
+            "answer": "No. MathWorks documents GPU-array inputs, but the function does not run on the GPU. RunMat gathers valid formatting values and throws from the host."
         },
         {
-            "question": "Can I rethrow an existing `MException`?",
-            "answer": "Yes. Pass the object returned by `catch err` directly to `error(err)` to propagate it unchanged."
+            "question": "Are suggested corrections implemented?",
+            "answer": "Not yet. RunMat does not currently model the three matlab.lang.correction object classes, so correction-object calls report the infrastructure gap explicitly."
         },
         {
-            "question": "What happens if I pass extra arguments after an `MException` or struct?",
-            "answer": "RunMat treats that as invalid usage and raises `RunMat:error` explaining that no additional arguments are allowed in those forms."
-        },
-        {
-            "question": "Does `error` run on the GPU?",
-            "answer": "No. The builtin executes on the host. If the message references GPU data, RunMat gathers the values before formatting the diagnostic string."
-        },
-        {
-            "question": "What if I call `error` without arguments?",
-            "answer": "RunMat raises `RunMat:error` indicating that a message is required, matching MATLAB's behaviour."
-        },
-        {
-            "question": "Why was my identifier normalised to `RunMat:...`?",
-            "answer": "MATLAB requires message identifiers to contain at least one namespace separator (`:`). RunMat enforces this rule so diagnostics integrate cleanly with tooling that expects fully-qualified identifiers."
-        },
-        {
-            "question": "Can the message span multiple lines?",
-            "answer": "Yes. Any newline characters in the formatted message are preserved exactly in the thrown exception."
-        },
-        {
-            "question": "Does formatting follow MATLAB rules?",
-            "answer": "Yes. `error` uses the same formatter as `sprintf`, including width/precision specifiers and numeric conversions, and will raise `RunMat:error` if the format string is invalid or under-specified. #"
+            "question": "Does errorStruct preserve an explicit stack?",
+            "answer": "Not yet. Message and identifier fields are supported, but translating MATLAB stack structure arrays into RuntimeError call frames remains deferred."
         }
     ],
     "links": [
         {
-            "label": "assert",
-            "url": "./assert"
+            "label": "MathWorks error documentation",
+            "url": "https://www.mathworks.com/help/matlab/ref/error.html"
+        },
+        {
+            "label": "sprintf",
+            "url": "./sprintf"
         },
         {
             "label": "warning",
             "url": "./warning"
         }
     ],
+    "syntax": {
+        "example": {
+            "description": "Documented forms",
+            "input": "error(msg)\nerror(msg,A)\nerror(errID,___)\nerror(errorStruct)\nerror(correction,___)",
+            "output": "The call normally throws and has no output value. All-empty inputs are a documented no-op."
+        },
+        "points": [
+            "`msg` and `errID` are text scalars.",
+            "`A` is a character vector, string scalar, or numeric scalar; typed integer scalars are accepted exactly.",
+            "`errorStruct` is a scalar structure containing at least one of message, identifier, or stack.",
+            "Correction objects and explicit stack reconstruction are tracked infrastructure gaps."
+        ]
+    },
     "source": {
         "label": "`crates/runmat-runtime/src/builtins/diagnostics/error.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/diagnostics/error.rs"
     },
-    "gpu_residency": "`error` is a control-flow builtin and never executes on the GPU. When formatting messages that include GPU-resident arrays (for example, via `%g` or `%s` specifiers), RunMat first gathers those values back to host memory so that the final diagnostic message accurately reflects the data the user passed.",
-    "gpu_behavior": [
-        "`error` is a control-flow builtin and never executes on the GPU. When formatting messages that include GPU-resident arrays (for example, via `%g` or `%s` specifiers), RunMat first gathers those values back to host memory so that the final diagnostic message accurately reflects the data the user passed."
-    ],
+    "gpu_residency": "Formatting values gather to host after message and identifier validation; error is a host control-flow operation.",
     "key": "error",
     "slug": "error",
     "aliases": [],

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

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/generated/builtins/error.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,OAAO;QACP,WAAW;QACX,OAAO;QACP,aAAa;QACb,SAAS;KACV;IACD,SAAS,EAAE,gFAAgF;IAC3F,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qGAAqG;KAC/G;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,qCAAqC;QAC7C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,oNAAoN;IACnO,WAAW,EAAE;QACX,sEAAsE;QACtE,uIAAuI;QACvI,4FAA4F;QAC5F,2FAA2F;QAC3F,oGAAoG;QACpG,sFAAsF;QACtF,+VAA+V;KAChW;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,sHAAsH;SAChI;QACD;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,wIAAwI;SAClJ;QACD;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,iJAAiJ;SAC3J;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,mOAAmO;SAC7O;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,4KAA4K;SACtL;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,yMAAyM;SACpN;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,kGAAkG;SAC7G;QACD;YACE,UAAU,EAAE,yEAAyE;YACrF,QAAQ,EAAE,mIAAmI;SAC9I;QACD;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,8IAA8I;SACzJ;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,kGAAkG;SAC7G;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,0MAA0M;SACrN;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,qGAAqG;SAChH;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,sMAAsM;SACjN;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,eAAe,EAAE,iTAAiT;IAClU,cAAc,EAAE;QACd,iTAAiT;KAClT;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,aAAa;KACd;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/generated/builtins/error.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,OAAO;QACP,WAAW;QACX,YAAY;QACZ,YAAY;QACZ,WAAW;KACZ;IACD,SAAS,EAAE,uEAAuE;IAClF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yLAAyL;KACnM;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,qCAAqC;QAC7C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,yOAAyO;IACxP,WAAW,EAAE;QACX,4FAA4F;QAC5F,2GAA2G;QAC3G,mJAAmJ;QACnJ,8MAA8M;QAC9M,oFAAoF;QACpF,2LAA2L;QAC3L,mJAAmJ;QACnJ,6LAA6L;KAC9L;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,+EAA+E;YACxF,QAAQ,EAAE,kEAAkE;SAC7E;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,mDAAmD;YAC5D,QAAQ,EAAE,2FAA2F;SACtG;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,sJAAsJ;SACjK;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,gKAAgK;SAC3K;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,qJAAqJ;SAChK;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,+BAA+B;YACxC,KAAK,EAAE,sDAAsD;SAC9D;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,kBAAkB;YACjC,OAAO,EAAE,uFAAuF;YAChG,QAAQ,EAAE,4FAA4F;SACvG;QACD,QAAQ,EAAE;YACR,qCAAqC;YACrC,0GAA0G;YAC1G,+FAA+F;YAC/F,uFAAuF;SACxF;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,eAAe,EAAE,mHAAmH;IACpI,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,aAAa;KACd;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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