runmat 0.6.1 → 0.6.2-dev.1

package/dist/generated/builtins/weboptions.js

@@ -10,13 +10,13 @@ const builtinDoc = {
         "headers",
         "rest client"
     ],
-    "summary": "Create HTTP options structs for `webread` and `webwrite` with MATLAB-compatible defaults.",
+    "summary": "Create options for HTTP requests.",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "weboptions operates on CPU data structures and gathers gpuArray inputs automatically."
+        "notes": "Options are host metadata. Automatically resident values may gather transparently, while explicit gpuArray input is available only as a named RunMat extension."
     },
     "fusion": {
         "elementwise": false,
@@ -39,12 +39,14 @@ const builtinDoc = {
             "builtins::io::http::weboptions::tests::webwrite_uses_weboptions_auto_request_method"
         ]
     },
-    "description": "`weboptions` builds MATLAB-style option structs controlling timeout, headers, content type, authentication, and request-method behavior for `webread` and `webwrite`.",
+    "description": "`weboptions` creates a host options structure for `webread`, `websave`, and `webwrite`.",
     "behaviors": [
-        "Returns a struct with canonical field names: `ContentType`, `Timeout`, `HeaderFields`, `UserAgent`, `Username`, `Password`, `RequestMethod`, `MediaType`, and `QueryParameters`.",
-        "Defaults mirror MATLAB: `ContentType=\"auto\"`, `Timeout=60`, `UserAgent=\"\"` (RunMat substitutes a default agent when this is empty), `RequestMethod=\"auto\"`, `MediaType=\"auto\"`, and empty structs for `HeaderFields` and `QueryParameters`.",
-        "Name-value arguments are case-insensitive. Values are validated to ensure MATLAB-compatible types (text scalars for string options, positive scalars for `Timeout`, structs or two-column cell arrays for `HeaderFields` and `QueryParameters`).",
-        "Passing an existing options struct as the first argument clones it before applying additional overrides, matching MATLAB's update pattern `opts = weboptions(opts, \"Timeout\", 5)`.",
+        "The implemented fields are `CharacterEncoding`, `UserAgent`, `Timeout`, `Username`, `Password`, `KeyName`, `KeyValue`, `ContentType`, `ContentReader`, `MediaType`, `RequestMethod`, `ArrayFormat`, `HeaderFields`, `CertificateFilename`, and the RunMat-only `QueryParameters` field.",
+        "The default timeout is 5 seconds. `Timeout` accepts a positive numeric scalar up to 2147.483647 seconds or `Inf`; native integer scalars are read exactly.",
+        "`KeyValue` accepts a text, numeric, or logical scalar and preserves a native integer scalar exactly.",
+        "Name-value arguments are case-insensitive. Implemented text properties require text scalars, and `HeaderFields` accepts a struct or two-column cell array.",
+        "Passing an existing structure as the first argument and the `QueryParameters` property are independently gated RunMat extensions.",
+        "`CharacterEncoding`, `ContentReader`, `ArrayFormat`, and `CertificateFilename` are represented in the returned structure but are not yet fully applied by every HTTP operation.",
         "Unknown option names raise descriptive errors."
     ],
     "examples": [
@@ -72,7 +74,7 @@ const builtinDoc = {
     "faqs": [
         {
             "question": "Which option names are supported in RunMat?",
-            "answer": "`weboptions` implements the options consumed by `webread` and `webwrite`: `ContentType`, `Timeout`, `HeaderFields`, `UserAgent`, `Username`, `Password`, `RequestMethod`, `MediaType`, and `QueryParameters`. Unknown names raise a MATLAB-style error."
+            "answer": "RunMat recognizes `CharacterEncoding`, `UserAgent`, `Timeout`, `Username`, `Password`, `KeyName`, `KeyValue`, `ContentType`, `ContentReader`, `MediaType`, `RequestMethod`, `ArrayFormat`, `HeaderFields`, `CertificateFilename`, and the RunMat-only `QueryParameters` property. Unknown names raise an error."
         },
         {
             "question": "What does `RequestMethod=\"auto\"` mean?",
@@ -84,11 +86,11 @@ const builtinDoc = {
         },
         {
             "question": "Can I pass query parameters through the options struct?",
-            "answer": "Yes. Supply a struct or two-column cell array in the `QueryParameters` option. Values may include numbers, logicals, or text scalars, and they are percent-encoded when the request is built."
+            "answer": "In RunMat mode, supply a struct or two-column cell array in the `QueryParameters` option. This convenience is outside the compatibility target and is rejected in MATLAB-compatible mode."
         },
         {
             "question": "Do I need to manage GPU residency for options?",
-            "answer": "No. `weboptions` gathers any GPU-resident values automatically and always returns a host struct. HTTP builtins ignore GPU residency for metadata."
+            "answer": "No manual gather is needed for values that became resident automatically. Explicit gpuArray option values are a named RunMat extension and are rejected in MATLAB-compatible mode. The returned options structure is host-resident."
         },
         {
             "question": "Does `weboptions` mutate the input struct?",
@@ -121,9 +123,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/io/http/weboptions.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/io/http/weboptions.rs"
     },
-    "gpu_residency": "No. `weboptions` gathers any GPU-resident values automatically and always returns a host struct. HTTP builtins ignore GPU residency for metadata.",
+    "gpu_residency": "The result is a host structure. Automatically resident inputs can gather transparently; explicit gpuArray input requires RunMat mode.",
     "gpu_behavior": [
-        "`weboptions` operates entirely on CPU metadata. It gathers any `gpuArray` inputs back to host memory before validation, because HTTP requests execute on the CPU regardless of the selected acceleration provider. No GPU provider hooks are required for this function."
+        "`weboptions` operates on host metadata. Automatic residency does not change source-language behavior, while an explicit gpuArray argument crosses the `weboptions-explicit-gpu-input` extension gate before provider access."
     ],
     "key": "weboptions",
     "slug": "weboptions",

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

@@ -1 +1 @@
-{"version":3,"file":"weboptions.js","sourceRoot":"","sources":["../../../src/generated/builtins/weboptions.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,YAAY;QACZ,cAAc;QACd,SAAS;QACT,SAAS;QACT,aAAa;KACd;IACD,SAAS,EAAE,2FAA2F;IACtG,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,uFAAuF;KACjG;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,uCAAuC;QAC/C,aAAa,EAAE;YACb,0FAA0F;YAC1F,iFAAiF;YACjF,2EAA2E;YAC3E,0EAA0E;YAC1E,4FAA4F;YAC5F,+EAA+E;YAC/E,uFAAuF;YACvF,wFAAwF;YACxF,qFAAqF;SACtF;KACF;IACD,aAAa,EAAE,uKAAuK;IACtL,WAAW,EAAE;QACX,kLAAkL;QAClL,qPAAqP;QACrP,kPAAkP;QAClP,sLAAsL;QACtL,gDAAgD;KACjD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,oFAAoF;SAC9F;QACD;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,gIAAgI;SAC1I;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,mNAAmN;SAC7N;QACD;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,2LAA2L;SACrM;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,qMAAqM;SAC/M;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,yPAAyP;SACpQ;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,iJAAiJ;SAC5J;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,wHAAwH;SACnI;QACD;YACE,UAAU,EAAE,yDAAyD;YACrE,QAAQ,EAAE,+LAA+L;SAC1M;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,mJAAmJ;SAC9J;QACD;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,8FAA8F;SACzG;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,8FAA8F;SACzG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,4DAA4D;QACrE,KAAK,EAAE,yGAAyG;KACjH;IACD,eAAe,EAAE,mJAAmJ;IACpK,cAAc,EAAE;QACd,0QAA0Q;KAC3Q;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,MAAM;KACP;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"weboptions.js","sourceRoot":"","sources":["../../../src/generated/builtins/weboptions.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,YAAY;QACZ,cAAc;QACd,SAAS;QACT,SAAS;QACT,aAAa;KACd;IACD,SAAS,EAAE,mCAAmC;IAC9C,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,iKAAiK;KAC3K;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,uCAAuC;QAC/C,aAAa,EAAE;YACb,0FAA0F;YAC1F,iFAAiF;YACjF,2EAA2E;YAC3E,0EAA0E;YAC1E,4FAA4F;YAC5F,+EAA+E;YAC/E,uFAAuF;YACvF,wFAAwF;YACxF,qFAAqF;SACtF;KACF;IACD,aAAa,EAAE,yFAAyF;IACxG,WAAW,EAAE;QACX,yRAAyR;QACzR,4JAA4J;QAC5J,sGAAsG;QACtG,4JAA4J;QAC5J,mIAAmI;QACnI,iLAAiL;QACjL,gDAAgD;KACjD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,oFAAoF;SAC9F;QACD;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,gIAAgI;SAC1I;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,mNAAmN;SAC7N;QACD;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,2LAA2L;SACrM;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,qMAAqM;SAC/M;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,iTAAiT;SAC5T;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,iJAAiJ;SAC5J;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,wHAAwH;SACnI;QACD;YACE,UAAU,EAAE,yDAAyD;YACrE,QAAQ,EAAE,2LAA2L;SACtM;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,qOAAqO;SAChP;QACD;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,8FAA8F;SACzG;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,8FAA8F;SACzG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,4DAA4D;QACrE,KAAK,EAAE,yGAAyG;KACjH;IACD,eAAe,EAAE,uIAAuI;IACxJ,cAAc,EAAE;QACd,8NAA8N;KAC/N;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,MAAM;KACP;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"webread.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/webread.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAkJjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"webread.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/webread.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/webread.js

@@ -11,13 +11,13 @@ const builtinDoc = {
         "https",
         "api"
     ],
-    "summary": "Read web content over HTTP/HTTPS and decode responses with MATLAB-compatible behavior.",
+    "summary": "Read and decode content from a web service.",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "webread always gathers gpuArray inputs and executes on the CPU."
+        "notes": "HTTP execution is host-side. Automatically resident values gather transparently; explicit gpuArray input requires RunMat mode."
     },
     "fusion": {
         "elementwise": false,
@@ -38,14 +38,16 @@ const builtinDoc = {
             "builtins::io::http::webread::tests::webread_queryparameters_option_struct"
         ]
     },
-    "description": "`webread` issues HTTP/HTTPS requests and returns decoded response content (text, JSON, or bytes) using MATLAB-compatible `weboptions` and query-parameter workflows.",
+    "description": "`webread` issues an HTTP or HTTPS GET request and decodes the response according to its content type and options.",
     "behaviors": [
         "Accepts URLs supplied as character vectors or string scalars; the URL must be absolute.",
-        "Optional `weboptions`-style fields (either through a struct argument or name-value pairs) control content decoding (`ContentType`), request timeout (`Timeout`), headers (`HeaderFields`), and authentication (`Username`/`Password`). The builtin currently supports the default `GET` request method; use `webwrite` for POST/PUT uploads.",
-        "Additional name-value pairs that do not match an option are appended to the query string using percent-encoding. A leading struct or cell array argument can also supply query parameters.",
+        "Query names are text. Query values may be text, numeric, or logical scalars or vectors; native integer values are formatted from exact storage without conversion to double. Vector values use comma-separated formatting in the current implementation.",
+        "A final options structure controls response decoding (`ContentType`), timeout (`Timeout`), headers (`HeaderFields`), and authentication (`Username` and `Password`). The default timeout is 5 seconds, and an integer timeout is read exactly.",
+        "RunMat also accepts a leading structure or cell array of query parameters and recognizes option-like direct name-value pairs. These conveniences do not replace the portable query-pair plus final-options form.",
         "`ContentType 'auto'` (default) inspects the `Content-Type` response header to choose between JSON, text, or binary decoding. Explicit `ContentType 'json'`, `'text'`, or `'binary'` override the detection logic.",
         "JSON responses are parsed with the same rules as `jsondecode`, producing doubles, logicals, strings, structs, and cell arrays that match MATLAB semantics.",
-        "Text responses preserve the server-provided character encoding (UTF-8 with automatic decoding of exotic charsets exposed in the HTTP headers). Binary payloads return `1×N` double arrays whose entries store byte values in the range 0–255.",
+        "Text responses use the response character encoding when supported. Binary payloads return an exact `1×N uint8` row vector.",
+        "Image, audio, table, XML DOM, raw-response, and custom `ContentReader` result forms are not yet implemented.",
         "HTTP errors (non-2xx status codes), timeouts, TLS failures, and parsing problems raise descriptive MATLAB-style errors."
     ],
     "examples": [
@@ -78,7 +80,7 @@ const builtinDoc = {
         },
         {
             "question": "How do I control request timeouts?",
-            "answer": "Supply `\"Timeout\", seconds` as a name-value pair or in an options struct. The default timeout is 60 seconds. Timeouts raise `webread: request to <url> timed out`."
+            "answer": "Set `Timeout` in a final options structure. The default is 5 seconds; a positive scalar up to 2147.483647 seconds or `Inf` is accepted."
         },
         {
             "question": "What headers can I set?",
@@ -98,7 +100,7 @@ const builtinDoc = {
         },
         {
             "question": "How are binary responses represented?",
-            "answer": "Binary payloads return `1×N` double arrays whose elements are byte values. Convert them to the desired integer type (for example `uint8`) before further processing."
+            "answer": "Binary payloads return an exact `1×N uint8` row vector."
         },
         {
             "question": "What happens when the server returns an error status?",
@@ -110,7 +112,7 @@ const builtinDoc = {
         },
         {
             "question": "Can I pass query parameters as GPU arrays?",
-            "answer": "Yes. Inputs wrapped in `gpuArray` are gathered before assembling the query string."
+            "answer": "Automatically resident query values gather transparently. Explicit gpuArray query values are supported only in RunMat mode and are rejected before provider access in MATLAB-compatible mode."
         }
     ],
     "links": [
@@ -135,9 +137,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/io/http/webread.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/io/http/webread.rs"
     },
-    "gpu_residency": "No. `webread` gathers any GPU-resident values before contacting the network and produces host results. Keeping inputs on the GPU offers no benefit because HTTP/TLS stacks operate on the CPU.",
+    "gpu_residency": "HTTP and TLS execute on the host and results are host-resident. Automatically resident values gather transparently; explicit gpuArray input requires RunMat mode.",
     "gpu_behavior": [
-        "`webread` runs entirely on the CPU. Any `gpuArray` inputs (for example, query parameter values) are gathered to host memory before building the HTTP request. Results are produced on the host, and fusion graphs terminate at this builtin via `ResidencyPolicy::GatherImmediately`."
+        "The request path terminates fusion and gathers automatically resident values through their owning provider. Explicit gpuArray input crosses the `webread-explicit-gpu-input` extension gate before any gather."
     ],
     "key": "webread",
     "slug": "webread",

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

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

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

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

package/dist/generated/builtins/websave.js

@@ -12,7 +12,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Host-side compatibility builtin; GPU-resident inputs are gathered before execution."
+        "notes": "HTTP and file execution is host-side. Automatically resident values gather transparently; explicit gpuArray input requires RunMat mode."
     },
     "fusion": {
         "elementwise": false,
@@ -25,16 +25,41 @@ const builtinDoc = {
         "unit": "builtins::io::http::compat::tests",
         "integration": null
     },
-    "description": "Download URL content into a file.",
+    "description": "`websave` downloads an HTTP or HTTPS response to a file and returns the saved filename.",
     "behaviors": [
         "Downloads HTTP or HTTPS URL content through the shared RunMat HTTP transport and writes it through the active filesystem provider.",
-        "Supports a leading weboptions-style struct for Timeout, UserAgent, and HeaderFields.",
-        "Treats trailing name-value pairs as URL query parameters, with Timeout and UserAgent handled as request options.",
+        "The filename and URL are host text values. Native integer and resident numeric values are rejected for these roles.",
+        "Query names are text. Query values may be text, numeric, or logical scalars or vectors; native integers are formatted exactly and vectors use comma-separated formatting.",
+        "A final options structure can supply `Timeout`, `UserAgent`, and `HeaderFields`. The default timeout is 5 seconds, and an integer timeout is read exactly.",
+        "RunMat also recognizes direct `Timeout` and `UserAgent` name-value pairs as request options.",
         "Rejects unpaired or unsupported option shapes instead of silently ignoring them."
     ],
-    "examples": [],
-    "faqs": [],
-    "links": [],
+    "examples": [
+        {
+            "description": "Download a file with a query value",
+            "input": "saved = websave(\"report.json\", \"https://api.example.com/report\", \"id\", uint64(42))"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does websave require a manual gather?",
+            "answer": "No manual gather is needed for automatically resident query values. Explicit gpuArray input is a named RunMat extension and is rejected before provider access in MATLAB-compatible mode."
+        }
+    ],
+    "links": [
+        {
+            "label": "weboptions",
+            "url": "./weboptions"
+        },
+        {
+            "label": "webread",
+            "url": "./webread"
+        }
+    ],
+    "gpu_residency": "The network request and saved result are host-side. Automatically resident values can gather transparently; explicit gpuArray input requires RunMat mode.",
+    "gpu_behavior": [
+        "The request path gathers automatically resident query values through their owning provider. Explicit gpuArray input crosses the `websave-explicit-gpu-input` extension gate before any gather."
+    ],
     "key": "websave",
     "slug": "websave",
     "aliases": [],

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

@@ -1 +1 @@
-{"version":3,"file":"websave.js","sourceRoot":"","sources":["../../../src/generated/builtins/websave.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,SAAS;KACV;IACD,SAAS,EAAE,mCAAmC;IAC9C,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qFAAqF;KAC/F;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,mCAAmC;QAC3C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,mCAAmC;IAClD,WAAW,EAAE;QACX,oIAAoI;QACpI,sFAAsF;QACtF,kHAAkH;QAClH,kFAAkF;KACnF;IACD,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,MAAM;KACP;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"websave.js","sourceRoot":"","sources":["../../../src/generated/builtins/websave.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,SAAS;KACV;IACD,SAAS,EAAE,mCAAmC;IAC9C,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yIAAyI;KACnJ;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,mCAAmC;QAC3C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,yFAAyF;IACxG,WAAW,EAAE;QACX,oIAAoI;QACpI,qHAAqH;QACrH,2KAA2K;QAC3K,4JAA4J;QAC5J,8FAA8F;QAC9F,kFAAkF;KACnF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,0FAA0F;SACpG;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,2LAA2L;SACtM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,eAAe,EAAE,2JAA2J;IAC5K,cAAc,EAAE;QACd,gMAAgM;KACjM;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,MAAM;KACP;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/webwrite.js

@@ -11,13 +11,13 @@ const builtinDoc = {
         "form post",
         "binary upload"
     ],
-    "summary": "Write data to web services via HTTP and return decoded responses with MATLAB-compatible behavior.",
+    "summary": "Write data to a web service and decode its response.",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "webwrite gathers gpuArray inputs and executes entirely on the CPU networking stack."
+        "notes": "HTTP execution is host-side. Automatically resident values gather transparently; explicit gpuArray input requires RunMat mode."
     },
     "fusion": {
         "elementwise": false,
@@ -36,14 +36,15 @@ const builtinDoc = {
             "builtins::io::http::webwrite::tests::webwrite_binary_payload_respected"
         ]
     },
-    "description": "`webwrite` sends request payloads to HTTP/HTTPS endpoints using methods like POST/PUT/PATCH/DELETE and decodes responses using MATLAB-compatible `weboptions` conventions.",
+    "description": "`webwrite` sends data to an HTTP or HTTPS service and decodes the response according to its content type and options.",
     "behaviors": [
         "The first input is an absolute URL supplied as a character vector or string scalar.",
-        "The second input supplies the request body. Structs and two-column cell arrays become `application/x-www-form-urlencoded` payloads. Character vectors / strings are sent as UTF-8 text, and other MATLAB values default to JSON encoding via `jsonencode`.",
-        "Name-value arguments (or an options struct) accept the same fields as MATLAB `weboptions`: `ContentType`, `MediaType`, `Timeout`, `HeaderFields`, `Username`, `Password`, `UserAgent`, `RequestMethod`, and `QueryParameters`.",
+        "Post names are text. Post values may be text, numeric, logical, or datetime values, including supported arrays; native integer values are serialized from exact storage.",
+        "A structure or supported numeric value may be used as JSON data. Nested native integer values remain exact through JSON serialization.",
+        "A final options structure controls `ContentType`, `MediaType`, `Timeout`, `HeaderFields`, `Username`, `Password`, `UserAgent`, and `RequestMethod`. The default timeout is 5 seconds, and an integer timeout is read exactly.",
         "`ContentType` controls how the response is parsed (`\"auto\"` by default). Set it to `\"json\"`, `\"text\"`, or `\"binary\"` to force JSON decoding, text return, or raw byte vectors.",
         "`MediaType` sets the outbound `Content-Type` header. When omitted, RunMat chooses a sensible default (`application/x-www-form-urlencoded`, `application/json`, `text/plain; charset=utf-8`, or `application/octet-stream`) based on the payload.",
-        "Query parameters can be appended through the `QueryParameters` option or by including additional, unrecognised name-value pairs. Parameter values follow MATLAB scalar rules.",
+        "RunMat additionally supports `QueryParameters`, direct option-like name-value pairs, and raw byte-oriented uploads. These conveniences are distinct from the portable post-pair plus final-options form.",
         "HTTP errors, timeouts, TLS verification problems, and JSON encoding issues raise MATLAB-style errors with descriptive text."
     ],
     "examples": [
@@ -104,11 +105,11 @@ const builtinDoc = {
         },
         {
             "question": "How do timeouts work?",
-            "answer": "`Timeout` accepts a scalar number of seconds. The default is 60 s. Requests exceeding the limit raise `webwrite: request to <url> timed out`."
+            "answer": "`Timeout` accepts a positive numeric scalar up to 2147.483647 seconds or `Inf`. The default is 5 seconds."
         },
         {
             "question": "What happens with GPU inputs?",
-            "answer": "They are gathered before serialisation. The function is marked as a sink to break fusion graphs and ensure residency is released."
+            "answer": "Automatically resident values gather transparently before serialization. Explicit gpuArray input is a named RunMat extension and is rejected before provider access in MATLAB-compatible mode."
         }
     ],
     "links": [
@@ -137,9 +138,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/io/http/webwrite.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/io/http/webwrite.rs"
     },
-    "gpu_residency": "No. `webwrite` executes on the CPU. Any GPU values are automatically gathered before serialising the payload, and results are created on the host. Manually gathering is unnecessary.",
+    "gpu_residency": "Requests and results are host-side. Automatically resident values gather transparently; explicit gpuArray input requires RunMat mode.",
     "gpu_behavior": [
-        "`webwrite` is a sink in the execution graph. Any GPU-resident inputs (for example tensors inside structs or cell arrays) are gathered to host memory before encoding the request body. Network I/O always runs on the CPU; fusion plans are terminated with `ResidencyPolicy::GatherImmediately`."
+        "The request path terminates fusion and gathers automatically resident values through their owning provider. Explicit gpuArray input crosses the `webwrite-explicit-gpu-input` extension gate before any gather."
     ],
     "key": "webwrite",
     "slug": "webwrite",

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

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

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

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

package/dist/generated/builtins/what.js

@@ -12,7 +12,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Host-side compatibility builtin; GPU-resident inputs are gathered before execution."
+        "notes": "Filesystem inspection is host-side. Numeric and resident inputs are rejected without provider access."
     },
     "fusion": {
         "elementwise": false,
@@ -25,14 +25,20 @@ const builtinDoc = {
         "unit": null,
         "integration": null
     },
-    "description": "Summarize MATLAB-related files in a folder.",
+    "description": "`what` summarizes recognized source and data files in the current folder or a named folder.",
     "behaviors": [
-        "Accepts MATLAB text inputs such as string scalars and character row vectors for path, name, or URL arguments where applicable.",
-        "Runs on the host using the active RunMat filesystem, environment, or HTTP abstraction as appropriate.",
-        "Reports MATLAB-style runtime errors for unsupported argument shapes or unavailable host capabilities."
+        "With no input, inspects the current folder. An optional folder must be a host string scalar or character row vector.",
+        "Returns a scalar structure whose implemented fields group recognized files in the selected folder.",
+        "Native integer, floating, logical, and resident numeric folder values are invalid and reject before filesystem or provider access.",
+        "Additional file categories and package/class details not represented by the current structure remain unsupported."
     ],
     "examples": [],
-    "faqs": [],
+    "faqs": [
+        {
+            "question": "Does what gather a numeric folder argument?",
+            "answer": "No. A folder is text, so numeric and resident values are rejected before any gather or filesystem access."
+        }
+    ],
     "links": [],
     "key": "what",
     "slug": "what",

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

@@ -1 +1 @@
-{"version":3,"file":"what.js","sourceRoot":"","sources":["../../../src/generated/builtins/what.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,MAAM;KACP;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,qFAAqF;KAC/F;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,IAAI;QACZ,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,6CAA6C;IAC5D,WAAW,EAAE;QACX,gIAAgI;QAChI,uGAAuG;QACvG,uGAAuG;KACxG;IACD,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"what.js","sourceRoot":"","sources":["../../../src/generated/builtins/what.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,MAAM;KACP;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,uGAAuG;KACjH;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,IAAI;QACZ,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,6FAA6F;IAC5G,WAAW,EAAE;QACX,sHAAsH;QACtH,oGAAoG;QACpG,oIAAoI;QACpI,mHAAmH;KACpH;IACD,UAAU,EAAE,EAAE;IACd,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,2GAA2G;SACtH;KACF;IACD,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/width.js

@@ -0,0 +1,89 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "width",
+    "category": "table",
+    "keywords": [
+        "width",
+        "table",
+        "array",
+        "columns",
+        "variables"
+    ],
+    "summary": "Return the number of table variables or array columns.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64",
+            "i8",
+            "i16",
+            "i32",
+            "i64",
+            "u8",
+            "u16",
+            "u32",
+            "u64"
+        ],
+        "broadcasting": "none",
+        "notes": "Resident numeric arrays are answered from handle shape metadata without gathering their elements."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::table::builtins::predicates::tests",
+        "integration": null
+    },
+    "description": "`width(T)` returns the number of variables in a table or the number of columns in an array.",
+    "behaviors": [
+        "For a table, the result is its variable count. For an ordinary array, the result is the size of its second dimension.",
+        "All eight native integer classes follow the same structural rule; their elements are neither converted nor inspected.",
+        "The result is a host `double` scalar.",
+        "For a resident numeric array, RunMat reads the column count directly from handle shape metadata without gathering payload data."
+    ],
+    "examples": [
+        {
+            "description": "Count array columns",
+            "input": "n = width(uint16(zeros(3, 5)))",
+            "output": "n = 5"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does width gather a gpuArray?",
+            "answer": "No. RunMat obtains the column count from resident shape metadata and returns a host double scalar."
+        }
+    ],
+    "links": [
+        {
+            "label": "height",
+            "url": "./height"
+        },
+        {
+            "label": "size",
+            "url": "./size"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/table/builtins/predicates.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/table/builtins/predicates.rs"
+    },
+    "gpu_residency": "Numeric payloads remain resident; only shape metadata is read.",
+    "gpu_behavior": [
+        "`width` does not dispatch a numerical kernel or gather the input. It returns the second handle dimension as a host double scalar."
+    ],
+    "key": "width",
+    "slug": "width",
+    "aliases": [],
+    "categoryPath": [
+        "table"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=width.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"width.js","sourceRoot":"","sources":["../../../src/generated/builtins/width.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,OAAO;QACP,OAAO;QACP,OAAO;QACP,SAAS;QACT,WAAW;KACZ;IACD,SAAS,EAAE,wDAAwD;IACnE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;YACL,IAAI;YACJ,KAAK;YACL,KAAK;YACL,KAAK;YACL,IAAI;YACJ,KAAK;YACL,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mGAAmG;KAC7G;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,8CAA8C;QACtD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,6FAA6F;IAC5G,WAAW,EAAE;QACX,uHAAuH;QACvH,uHAAuH;QACvH,uCAAuC;QACvC,iIAAiI;KAClI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,gCAAgC;YACzC,QAAQ,EAAE,OAAO;SAClB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+BAA+B;YAC3C,QAAQ,EAAE,oGAAoG;SAC/G;KACF;IACD,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,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,eAAe,EAAE,gEAAgE;IACjF,cAAc,EAAE;QACd,mIAAmI;KACpI;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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