runmat 0.6.1-dev.1 → 0.6.2-dev.0

package/dist/generated/builtins/empty.js

@@ -0,0 +1,120 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "empty",
+    "category": "array/creation",
+    "keywords": [
+        "empty",
+        "ClassName.empty",
+        "integer",
+        "preallocate",
+        "array"
+    ],
+    "summary": "Create an empty array of a specified class.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Primitive integer ClassName.empty forms construct exact host integer storage. A resident size control is a compatibility-gated RunMat extension and is gathered only after validation and gating."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::array::creation::empty::tests",
+        "integration": null
+    },
+    "description": "`ClassName.empty` creates a 0-by-0 empty array of the receiver class. Size arguments can specify other empty shapes, but at least one normalized dimension must be zero.",
+    "behaviors": [
+        "RunMat registers class-qualified forms for `int8.empty`, `int16.empty`, `int32.empty`, `int64.empty`, `uint8.empty`, `uint16.empty`, `uint32.empty`, and `uint64.empty`.",
+        "All eight integer classes are accepted for scalar dimension controls and row size vectors. Values are decoded from authoritative integer storage without conversion through double.",
+        "Signed negative dimensions become zero. Nonnegative dimensions must be integer-valued and within the platform size range.",
+        "A single scalar dimension requests a square shape. A size-vector argument must be a row vector; column vectors reject.",
+        "Trailing singleton dimensions after dimension two are removed. At least one remaining dimension must be zero.",
+        "Integer outputs contain exact empty `IntegerStorage` of the receiver class.",
+        "The global `empty(...)` shorthand and its trailing typename selector are RunMat-only extensions. MATLAB-compatible mode requires class-qualified syntax.",
+        "The former global `\"like\"` shorthand is not retained because it did not inherit output class and is not part of the documented class-static surface.",
+        "User-defined and general object-class empty arrays require broader class-array storage and static-method dispatch support."
+    ],
+    "examples": [
+        {
+            "description": "Create an empty unsigned integer array",
+            "input": "A = uint8.empty",
+            "output": "`A` is a 0-by-0 uint8 array with authoritative uint8 storage."
+        },
+        {
+            "description": "Create an empty integer array with a nonzero second dimension",
+            "input": "A = int16.empty(int64(0), uint64(5))",
+            "output": "`A` is a 0-by-5 int16 array."
+        },
+        {
+            "description": "Use a row size vector",
+            "input": "A = uint64.empty(uint32([0 0 6]))",
+            "output": "`A` is a 0-by-0-by-6 uint64 array."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does the class come from a size argument?",
+            "answer": "No. In MATLAB-compatible syntax the receiver in `ClassName.empty` determines the output class. Integer size arguments are structural controls only."
+        },
+        {
+            "question": "Are wide uint64 dimensions converted through double?",
+            "answer": "No. Host integer controls are decoded exactly from integer storage and checked against the platform size range."
+        },
+        {
+            "question": "Can empty create a nonempty array?",
+            "answer": "No. After signed-negative clamping and trailing-singleton normalization, at least one dimension must be zero."
+        },
+        {
+            "question": "Can I call empty as a global function?",
+            "answer": "Only in RunMat mode. The global shorthand is explicitly compatibility-gated; portable MATLAB-compatible code uses `ClassName.empty`."
+        }
+    ],
+    "links": [
+        {
+            "label": "MathWorks empty documentation",
+            "url": "https://www.mathworks.com/help/matlab/ref/empty.html"
+        },
+        {
+            "label": "isempty",
+            "url": "./isempty"
+        },
+        {
+            "label": "zeros",
+            "url": "./zeros"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported MATLAB-compatible forms",
+            "input": "A = ClassName.empty\nA = ClassName.empty(sz1, ..., szN)\nA = ClassName.empty(sizeVector)",
+            "output": "`A` is empty and preserves the receiver class."
+        },
+        "points": [
+            "At least one normalized dimension must be zero.",
+            "A size vector must be a row vector.",
+            "Signed negative dimensions are treated as zero.",
+            "Trailing singleton dimensions after dimension two are omitted."
+        ]
+    },
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/array/creation/empty.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/array/creation/empty.rs"
+    },
+    "gpu_residency": "Integer class-static forms construct host empty storage. Resident numeric size controls are accepted only in RunMat mode and reject before provider access when extensions are disabled.",
+    "key": "empty",
+    "slug": "empty",
+    "aliases": [],
+    "categoryPath": [
+        "array",
+        "creation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=empty.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"empty.js","sourceRoot":"","sources":["../../../src/generated/builtins/empty.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE;QACV,OAAO;QACP,iBAAiB;QACjB,SAAS;QACT,aAAa;QACb,OAAO;KACR;IACD,SAAS,EAAE,6CAA6C;IACxD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mMAAmM;KAC7M;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,IAAI;KACpB;IACD,aAAa,EAAE,0KAA0K;IACzL,WAAW,EAAE;QACX,0KAA0K;QAC1K,qLAAqL;QACrL,2HAA2H;QAC3H,wHAAwH;QACxH,+GAA+G;QAC/G,6EAA6E;QAC7E,0JAA0J;QAC1J,wJAAwJ;QACxJ,4HAA4H;KAC7H;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,+DAA+D;SAC1E;QACD;YACE,aAAa,EAAE,+DAA+D;YAC9E,OAAO,EAAE,sCAAsC;YAC/C,QAAQ,EAAE,8BAA8B;SACzC;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,mCAAmC;YAC5C,QAAQ,EAAE,oCAAoC;SAC/C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,qJAAqJ;SAChK;QACD;YACE,UAAU,EAAE,sDAAsD;YAClE,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,+GAA+G;SAC1H;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,sIAAsI;SACjJ;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,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,0FAA0F;YACnG,QAAQ,EAAE,gDAAgD;SAC3D;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,qCAAqC;YACrC,iDAAiD;YACjD,gEAAgE;SACjE;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,eAAe,EAAE,0LAA0L;IAC3M,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/encode.js

@@ -16,7 +16,7 @@ const builtinDoc = {
         "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."
+        "notes": "`encode` is an object/text host operation. Resident numeric model or document arguments reject before provider access; only a compatibility-gated resident ForceCellOutput control can be gathered."
     },
     "fusion": {
         "elementwise": false,
@@ -39,7 +39,8 @@ const builtinDoc = {
         "`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."
+        "Non-scalar bag object arrays and native MATLAB sparse model storage remain broader Text Analytics/runtime work.",
+        "Integer and numeric model/document values are never converted to text. RunMat mode optionally accepts exact scalar integer ForceCellOutput predicates behind an extension gate; zero is false and every nonzero integer is true."
     ],
     "examples": [
         {
@@ -69,10 +70,14 @@ const builtinDoc = {
         },
         {
             "question": "Does `encode` execute on the GPU?",
-            "answer": "No. It gathers provider inputs when needed, uses host text metadata, and returns host sparse values."
+            "answer": "No. Bag models and documents are host object/text values. Numeric resident values in those roles reject before provider access; only a RunMat-mode resident ForceCellOutput control can gather after validation and gating."
         }
     ],
     "links": [
+        {
+            "label": "MathWorks encode documentation",
+            "url": "https://www.mathworks.com/help/textanalytics/ref/bagofwords.encode.html"
+        },
         {
             "label": "bagOfWords",
             "url": "./bagOfWords"
@@ -104,7 +109,7 @@ const builtinDoc = {
         "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.",
+    "gpu_residency": "`encode` returns host sparse output. It does not gather model or document arguments speculatively; invalid numeric resident values reject before provider access. A resident ForceCellOutput scalar is a separately gated RunMat extension.",
     "key": "encode",
     "slug": "encode",
     "aliases": [],

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

@@ -1 +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"}
+{"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,qMAAqM;KAC/M;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;QACjH,kOAAkO;KACnO;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,6NAA6N;SACxO;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,gCAAgC;YACzC,KAAK,EAAE,yEAAyE;SACjF;QACD;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,6OAA6O;IAC9P,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/endsWith.d.ts.map

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

package/dist/generated/builtins/endsWith.js

@@ -15,8 +15,8 @@ const builtinDoc = {
         "elementwise": false,
         "reduction": false,
         "precisions": [],
-        "broadcasting": "matlab",
-        "notes": "Runs on the CPU; GPU-resident inputs are gathered automatically so behaviour matches MATLAB."
+        "broadcasting": "none",
+        "notes": "Runs on the host. Numeric resident subject or pattern values are not text and reject before provider access; a resident IgnoreCase control is a compatibility-gated RunMat extension."
     },
     "fusion": {
         "elementwise": false,
@@ -29,16 +29,16 @@ const builtinDoc = {
         "unit": "builtins::strings::search::endswith::tests",
         "integration": "builtins::strings::search::endswith::tests::endswith_cell_array_patterns"
     },
-    "description": "`endsWith(str, pattern)` returns logical results indicating whether each element of `str` ends with the corresponding pattern. Supported text types and implicit expansion behavior follow MATLAB semantics.",
+    "description": "`endsWith(str, pattern)` returns one logical result for each element of `str`. When `pattern` has multiple elements, each element is an alternative and a subject matches if any pattern is a suffix.",
     "behaviors": [
         "Accepts text inputs as string scalars/arrays, character vectors/arrays, or cell arrays of character vectors.",
-        "Accepts patterns in the same formats; scalar inputs expand across the other argument following MATLAB broadcast rules.",
+        "Accepts patterns in the same formats. Multiple patterns form an alternatives set rather than an element-wise array paired with `str`.",
         "Missing string scalars (`<missing>`) never match any pattern.",
         "Empty patterns (`\"\"` or `''`) always match non-missing text elements.",
         "Patterns that are `<missing>` never match and therefore return `false`.",
         "Character arrays treat each row as an independent element; zero-row character arrays yield empty outputs.",
-        "The optional `IgnoreCase` flag can be supplied either as a trailing scalar or via the `'IgnoreCase', value` name-value pair. It accepts logical/numeric scalars and the strings `'on'`, `'off'`, `'true'`, and `'false'` (default is case-sensitive).",
-        "Returns a logical scalar when the broadcasted size is one element, otherwise returns a logical array."
+        "MATLAB-compatible mode accepts the documented `'IgnoreCase', logical` name-value form. RunMat mode additionally supports a positional flag and numeric or textual predicate values behind explicit extension gates.",
+        "Returns a logical scalar for a scalar subject and otherwise returns a logical array with the shape of `str`."
     ],
     "examples": [
         {
@@ -57,8 +57,8 @@ const builtinDoc = {
             "output": "tf = 1×3 logical array\n   0   0   1"
         },
         {
-            "description": "Use element-wise suffixes with implicit expansion",
-            "input": "names = [\"hydrogen\"; \"helium\"; \"lithium\"];\nsuffixes = [\"gen\"; \"ium\"; \"ium\"];\ntf = endsWith(names, suffixes)",
+            "description": "Test every subject against a set of suffixes",
+            "input": "names = [\"hydrogen\"; \"helium\"; \"lithium\"];\nsuffixes = [\"gen\"; \"ium\"];\ntf = endsWith(names, suffixes)",
             "output": "tf = 3×1 logical array\n   1\n   1\n   1"
         },
         {
@@ -67,9 +67,9 @@ const builtinDoc = {
             "output": "tf = 1×3 logical array\n   0   1   1"
         },
         {
-            "description": "Provide multiple suffixes as a column vector",
-            "input": "tf = endsWith(\"saturn\", ['n'; 'x'; 'r'])",
-            "output": "tf = 3×1 logical array\n   1\n   0\n   0"
+            "description": "Provide multiple suffixes",
+            "input": "tf = endsWith(\"saturn\", [\"n\" \"x\" \"r\"])",
+            "output": "tf = logical\n   1"
         },
         {
             "description": "Handle empty patterns and missing values",
@@ -80,11 +80,11 @@ const builtinDoc = {
     "faqs": [
         {
             "question": "What types can I pass to `endsWith`?",
-            "answer": "Use string scalars/arrays, character vectors/arrays, or cell arrays of character vectors for both arguments. Mixed combinations are accepted, and RunMat performs MATLAB-style implicit expansion when the array sizes differ."
+            "answer": "Use string arrays, character vectors, or cell arrays of character vectors for both arguments. Every pattern is tested as an alternative against each subject element."
         },
         {
             "question": "How do I ignore letter case?",
-            "answer": "Supply `'IgnoreCase', true` (or `'on'`) after the pattern argument. The option is case-insensitive, so `'ignorecase'` also works. The default is `false`, matching MATLAB."
+            "answer": "MATLAB-compatible mode uses `'IgnoreCase', true` or false. RunMat mode additionally accepts textual values such as `'on'` and a positional flag behind explicit extension gates. The option name is case-insensitive."
         },
         {
             "question": "What happens with empty patterns?",
@@ -92,7 +92,7 @@ const builtinDoc = {
         },
         {
             "question": "Can I provide multiple suffixes at once?",
-            "answer": "Yes. Provide `pattern` as a string array, character array, or cell array of character vectors. RunMat applies implicit expansion so that scalar inputs expand across the other argument automatically."
+            "answer": "Yes. Provide `pattern` as a string array, character vector, cell array of character vectors, or supported pattern object. A subject returns true when any supplied pattern is a suffix."
         },
         {
             "question": "How are missing strings treated?",
@@ -100,14 +100,18 @@ const builtinDoc = {
         },
         {
             "question": "Does `endsWith` run on the GPU?",
-            "answer": "No. The builtin executes on the CPU. If inputs reside on the GPU (for example, after other accelerated operations), RunMat gathers them automatically so behaviour matches MATLAB."
+            "answer": "No. Text values are host-resident. Numeric resident subject and pattern values reject before provider access. RunMat mode can gather an explicitly compatibility-gated resident IgnoreCase control."
         },
         {
             "question": "Does `endsWith` preserve the input shape?",
-            "answer": "Yes. The output is a logical array whose shape reflects the MATLAB-style implicit expansion result. When that shape contains exactly one element, the builtin returns a logical scalar."
+            "answer": "Yes. The output has the shape of `str`; pattern-array shape does not change it. A scalar subject produces a logical scalar."
         }
     ],
     "links": [
+        {
+            "label": "MathWorks endsWith documentation",
+            "url": "https://www.mathworks.com/help/matlab/ref/string.endswith.html"
+        },
         {
             "label": "`contains`",
             "url": "./contains"
@@ -133,9 +137,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/strings/search/endswith.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/search/endswith.rs"
     },
-    "gpu_residency": "You usually do NOT need to call `gpuArray` yourself in RunMat (unlike MATLAB).\n\n`endsWith` always executes on the host, but RunMat's runtime automatically gathers any GPU-resident inputs before evaluating the suffix check. Because the builtin registers a `ResidencyPolicy::GatherImmediately`, the planner gathers device handles eagerly and computes the logical result on the CPU. You may still call `gpuArray` manually for compatibility with MATLAB code; the runtime gathers the inputs just in time, so results match MATLAB precisely.",
+    "gpu_residency": "`endsWith` executes on host text. Numeric resident subject or pattern values reject before provider access. A resident scalar IgnoreCase control is available only in RunMat mode and is gathered after its extension gate succeeds.",
     "gpu_behavior": [
-        "`endsWith` performs host-side suffix comparison. When inputs currently live on the GPU, RunMat gathers them back to the host before evaluation so the behaviour is identical to MATLAB. No acceleration provider hooks are required for this builtin."
+        "`endsWith` performs host-side suffix comparison. It has no numeric GPU data path or fusion hook; only a compatibility-gated resident scalar control can cross the provider boundary."
     ],
     "key": "endswith",
     "slug": "endswith",

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

@@ -1 +1 @@
-{"version":3,"file":"endsWith.js","sourceRoot":"","sources":["../../../src/generated/builtins/endsWith.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"endsWith.js","sourceRoot":"","sources":["../../../src/generated/builtins/endsWith.ts"],"names":[],"mappings":"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"}

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

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

package/dist/generated/builtins/envelope.js

@@ -36,11 +36,13 @@ const builtinDoc = {
     "behaviors": [
         "`yupper = envelope(x)` returns the upper envelope.",
         "`[yupper, ylower] = envelope(x)` returns both bounds.",
-        "`envelope(x, n)` uses analytic mode and accepts `n` for MATLAB call-form compatibility.",
-        "`envelope(x, n, 'analytic')` computes an FFT-domain analytic envelope.",
+        "`envelope(x, n)` uses analytic mode and computes the analytic signal with a Kaiser-windowed Hilbert FIR filter of length `n`.",
+        "`envelope(x, n, 'analytic')` explicitly selects the same Hilbert FIR-filter path.",
         "`envelope(x, wl, 'rms')` computes a centered sliding RMS envelope over a window of `wl` samples.",
         "`envelope(x, np, 'peak')` detects local maxima/minima separated by at least `np` samples and interpolates them with a spline curve.",
-        "Statement form with no outputs plots the signal with the upper and lower envelopes."
+        "Statement form with no outputs plots the signal with the upper and lower envelopes.",
+        "MATLAB-compatible mode accepts single- and double-precision signal data and controls. Typed-integer signal data or length controls are explicit RunMat extensions; integer data crosses into the floating envelope computation only after exact storage is read.",
+        "The public source does not state the output class for single-precision host input, so that compatibility detail remains evidence-open. RunMat preserves single-precision output for single-precision input consistently across host and resident execution."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/generated/builtins/envelope.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,UAAU;QACV,iBAAiB;QACjB,SAAS;QACT,KAAK;QACL,eAAe;QACf,mBAAmB;KACpB;IACD,SAAS,EAAE,2CAA2C;IACtD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,sNAAsN;KAChO;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;KAClD;IACD,aAAa,EAAE,uRAAuR;IACtS,WAAW,EAAE;QACX,oDAAoD;QACpD,uDAAuD;QACvD,yFAAyF;QACzF,wEAAwE;QACxE,kGAAkG;QAClG,qIAAqI;QACrI,qFAAqF;KACtF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,6FAA6F;SACvG;QACD;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,mDAAmD;SAC7D;QACD;YACE,aAAa,EAAE,eAAe;YAC9B,OAAO,EAAE,2DAA2D;SACrE;QACD;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,+DAA+D;SACzE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,mFAAmF;SAC9F;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,6GAA6G;SACxH;QACD;YACE,UAAU,EAAE,qDAAqD;YACjE,QAAQ,EAAE,0GAA0G;SACrH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/generated/builtins/envelope.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,UAAU;QACV,iBAAiB;QACjB,SAAS;QACT,KAAK;QACL,eAAe;QACf,mBAAmB;KACpB;IACD,SAAS,EAAE,2CAA2C;IACtD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,sNAAsN;KAChO;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;KAClD;IACD,aAAa,EAAE,uRAAuR;IACtS,WAAW,EAAE;QACX,oDAAoD;QACpD,uDAAuD;QACvD,+HAA+H;QAC/H,mFAAmF;QACnF,kGAAkG;QAClG,qIAAqI;QACrI,qFAAqF;QACrF,kQAAkQ;QAClQ,6PAA6P;KAC9P;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,6FAA6F;SACvG;QACD;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,mDAAmD;SAC7D;QACD;YACE,aAAa,EAAE,eAAe;YAC9B,OAAO,EAAE,2DAA2D;SACrE;QACD;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,+DAA+D;SACzE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,mFAAmF;SAC9F;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,6GAA6G;SACxH;QACD;YACE,UAAU,EAAE,qDAAqD;YACjE,QAAQ,EAAE,0GAA0G;SACrH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/eq.js

@@ -36,13 +36,14 @@ const builtinDoc = {
     },
     "description": "`eq(A, B)` (or `A == B`) compares inputs element-wise for equality. Scalar expansion and output-shape behavior follow MATLAB and RunMat logical comparison semantics. When either operand is symbolic, equality constructs a symbolic equation.",
     "behaviors": [
-        "Numeric, logical, and character inputs are compared element-wise using MATLAB's implicit expansion rules.",
+        "Numeric, logical, and character inputs are compared element-wise using MATLAB's implicit expansion rules. All eight integer classes are supported, and mixed numeric comparisons retain exact integer values, including wide int64 and uint64 values.",
         "Complex numbers are equal only when both their real and imaginary parts match.",
         "Character arrays compare by Unicode code point; you can mix them with numeric arrays (`'A' == 65`) or strings.",
         "String scalars and string arrays compare lexically; implicit expansion works across the string dimensions.",
         "Symbolic scalar operands return symbolic equations, for example `Y(0) == 0`, instead of logical truth values.",
         "Handle objects compare by identity rather than by structural equality.",
-        "Mixed numeric/string inputs raise MATLAB-compatible type errors."
+        "Mixed numeric/string inputs raise MATLAB-compatible type errors.",
+        "When an exact resident integer comparison cannot run through a validated owner/device provider path, RunMat gathers the authoritative typed storage and evaluates the same exact host predicate; uint64 values are never rounded through f64."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"eq.js","sourceRoot":"","sources":["../../../src/generated/builtins/eq.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"eq.js","sourceRoot":"","sources":["../../../src/generated/builtins/eq.ts"],"names":[],"mappings":"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"}

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

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

package/dist/generated/builtins/erase.js

@@ -16,7 +16,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Runs on the CPU; RunMat gathers GPU-resident text before removing substrings."
+        "notes": "Runs on the CPU. RunMat has no resident text storage, so GPU-resident numeric arguments are rejected before gather."
     },
     "fusion": {
         "elementwise": false,
@@ -36,7 +36,8 @@ const builtinDoc = {
         "Character arrays are processed row by row. Rows shrink as characters are removed and are padded with spaces so the result remains a rectangular char array.",
         "Cell arrays must contain string scalars or character vectors. The result is a cell array with the same shape whose elements reflect the removed substrings.",
         "The `pattern` input can be a string scalar, string array, character array, or cell array of character vectors/string scalars. Provide either a scalar pattern or a list; an empty list leaves `text` unchanged.",
-        "Pattern values are treated literally—no regular expressions are used. Use [`replace`](./replace) or the regex builtins for pattern-based removal."
+        "String, character, and cell matches are treated literally. RunMat pattern objects use their compiled pattern expression, matching the documented pattern-object form.",
+        "Both arguments are text or pattern values. Numeric values, including every typed-integer class and nested resident numeric values, are rejected before any provider access."
     ],
     "examples": [
         {
@@ -158,9 +159,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/strings/transform/erase.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/transform/erase.rs"
     },
-    "gpu_residency": "No. `erase` automatically gathers GPU inputs and produces host results. You never need to move text to or from the GPU manually for this builtin, and `gpuArray` inputs are handled transparently.",
+    "gpu_residency": "No. `erase` accepts host text and pattern values only. GPU-resident numeric values are not text and are rejected before provider access.",
     "gpu_behavior": [
-        "`erase` executes on the CPU. When any argument is GPU-resident, RunMat gathers it to host memory before removing substrings. Outputs are returned on the host as well. Providers do not need to implement device kernels for this builtin, and the fusion planner treats it as a sink to avoid keeping text on the GPU."
+        "`erase` executes on host text containers. Resident numeric arguments, including values nested in cells, are rejected without downloading; providers do not implement a text kernel for this builtin."
     ],
     "key": "erase",
     "slug": "erase",

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

@@ -1 +1 @@
-{"version":3,"file":"erase.js","sourceRoot":"","sources":["../../../src/generated/builtins/erase.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"erase.js","sourceRoot":"","sources":["../../../src/generated/builtins/erase.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,OAAO;QACP,kBAAkB;QAClB,aAAa;QACb,qBAAqB;QACrB,iBAAiB;KAClB;IACD,SAAS,EAAE,qEAAqE;IAChF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qHAAqH;KAC/H;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,oGAAoG;QAC5G,aAAa,EAAE,4EAA4E;KAC5F;IACD,aAAa,EAAE,uJAAuJ;IACtK,WAAW,EAAE;QACX,0FAA0F;QAC1F,qGAAqG;QACrG,6JAA6J;QAC7J,6JAA6J;QAC7J,iNAAiN;QACjN,uKAAuK;QACvK,6KAA6K;KAC9K;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,iFAAiF;YAC1F,QAAQ,EAAE,gCAAgC;SAC3C;QACD;YACE,aAAa,EAAE,gEAAgE;YAC/E,OAAO,EAAE,8FAA8F;YACvG,QAAQ,EAAE,yDAAyD;SACpE;QACD;YACE,aAAa,EAAE,kEAAkE;YACjF,OAAO,EAAE,4EAA4E;YACrF,QAAQ,EAAE,gEAAgE;SAC3E;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,kFAAkF;YAC3F,QAAQ,EAAE,uDAAuD;SAClE;QACD;YACE,aAAa,EAAE,2DAA2D;YAC1E,OAAO,EAAE,sEAAsE;YAC/E,QAAQ,EAAE,mDAAmD;SAC9D;QACD;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,kGAAkG;YAC3G,QAAQ,EAAE,sFAAsF;SACjG;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,+HAA+H;SAC1I;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,uIAAuI;SAClJ;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,2FAA2F;SACtG;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,gGAAgG;SAC3G;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,8JAA8J;SACzK;QACD;YACE,UAAU,EAAE,mEAAmE;YAC/E,QAAQ,EAAE,0JAA0J;SACrK;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,kBAAkB;SAC1B;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iEAAiE;QAC1E,KAAK,EAAE,8GAA8G;KACtH;IACD,eAAe,EAAE,0IAA0I;IAC3J,cAAc,EAAE;QACd,sMAAsM;KACvM;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,WAAW;KACZ;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/eraseBetween.js

@@ -17,7 +17,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "matlab",
-        "notes": "Executes on the CPU. RunMat gathers GPU-resident inputs before deleting text and returns host-side results; the builtin is registered as an Accelerate sink so fusion never keeps the data on device."
+        "notes": "Executes on the CPU. Host text is required; RunMat mode can gather GPU-resident numeric position controls as an explicit extension."
     },
     "fusion": {
         "elementwise": false,
@@ -33,11 +33,13 @@ const builtinDoc = {
     "description": "`eraseBetween(text, start, stop)` removes text between two boundary markers. String/position markers, expansion rules, and `'Boundaries'` option behavior follow MATLAB semantics.",
     "behaviors": [
         "Accepts **string scalars**, **string arrays**, **character arrays** (row-by-row), and **cell arrays** containing string scalars or character vectors; the output keeps the same container type.",
-        "Boundary arguments can be text or numeric positions. Both boundaries in a call must use the same representation—mixing text and numeric markers raises a size/type error.",
+        "Boundary arguments can be literal text, scalar pattern objects, or numeric positions. Both boundaries in a call must use the same representation—mixing text/pattern and numeric markers raises a size/type error. Broader pattern-array containers depend on shared pattern-array runtime representation and are not claimed by this implementation.",
         "Text boundaries are **exclusive** by default: the markers are preserved while the enclosed text is deleted. Numeric positions are **inclusive** by default: characters at `startPos` and `endPos` are deleted together with the interior.",
         "`'Boundaries','inclusive'` removes the markers themselves; `'Boundaries','exclusive'` keeps them. The option is case-insensitive and must be supplied as name-value pairs.",
         "Missing string scalars propagate (the MATLAB `missing` placeholder in either boundary or text yields `<missing>` in the result). When a boundary cannot be located, `eraseBetween` returns the original element unchanged.",
-        "Numeric positions are validated as positive integers, clamped to the string length, and interpreted using MATLAB’s 1-based indexing rules."
+        "Numeric positions are validated as positive integers and interpreted using MATLAB’s 1-based indexing rules. All eight typed-integer classes are read exactly as documented numeric structural controls.",
+        "MATLAB-compatible array forms require each boundary to be scalar or the same size as the text input. RunMat mode additionally permits general broadcast-compatible boundary shapes.",
+        "Row-wise character matrices, cells containing string scalars, and GPU-resident position arrays are separately gated RunMat extensions."
     ],
     "examples": [
         {
@@ -91,7 +93,7 @@ const builtinDoc = {
         },
         {
             "question": "Can I broadcast scalar boundaries across an array input?",
-            "answer": "Yes. Scalar markers follow MATLAB implicit expansion rules. Character-array and cell-array markers must match the size of the text input."
+            "answer": "Scalar markers apply to every text element. Nonscalar boundary arrays must be the same size as the text input in MATLAB-compatible mode; RunMat mode separately enables general broadcast-compatible shapes."
         },
         {
             "question": "Are GPU inputs supported?",
@@ -99,7 +101,7 @@ const builtinDoc = {
         },
         {
             "question": "Does `eraseBetween` validate numeric positions?",
-            "answer": "Yes. Positions are parsed as positive integers using MATLAB’s 1-based indexing. Stops are clamped to the string length, and start positions that lie beyond the text leave the element unchanged."
+            "answer": "Yes. Positions are parsed exactly as positive integers using MATLAB’s 1-based indexing. The current public source does not fully specify every out-of-range case, so those details remain evidence-open rather than being presented as MATLAB guarantees."
         }
     ],
     "links": [
@@ -156,9 +158,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/strings/transform/erasebetween.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/transform/erasebetween.rs"
     },
-    "gpu_residency": "No. RunMat automatically gathers device-resident inputs, performs the deletion on the CPU, and returns host outputs. Manual `gpuArray` / `gather` calls are unnecessary; they are honoured only for compatibility with MATLAB when you explicitly need to control residency.",
+    "gpu_residency": "No text output remains resident. GPU-resident numeric position controls are a RunMat extension and are gathered exactly in RunMat mode; strict compatibility rejects them before provider access.",
     "gpu_behavior": [
-        "The builtin performs all work on the CPU. When any argument is GPU-resident, RunMat gathers the values first, applies the deletions on the host, and returns host-resident outputs. Providers do not need to expose device kernels, and fusion planning treats `eraseBetween` as a residency sink so surrounding expressions will gather automatically."
+        "The builtin performs text work on the CPU. In RunMat mode, resident numeric position controls gather through their authoritative storage and outputs remain on host; strict compatibility gates that extension before download."
     ],
     "key": "erasebetween",
     "slug": "erasebetween",

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

@@ -1 +1 @@
-{"version":3,"file":"eraseBetween.js","sourceRoot":"","sources":["../../../src/generated/builtins/eraseBetween.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"eraseBetween.js","sourceRoot":"","sources":["../../../src/generated/builtins/eraseBetween.ts"],"names":[],"mappings":"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"}

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

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