runmat 0.6.1 → 0.6.2-dev.1

package/dist/generated/builtins/false.js

@@ -9,13 +9,13 @@ const builtinDoc = {
         "array",
         "mask"
     ],
-    "summary": "Create logical arrays filled with false values in MATLAB and RunMat.",
+    "summary": "Create logical arrays filled with false values.",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Always constructs a host logical array; gpuArray inputs are used only for sizing."
+        "notes": "A resident `'like'` prototype creates a logical result on that handle's owning provider. Numeric size arguments remain structural controls and do not independently request GPU output."
     },
     "fusion": {
         "elementwise": false,
@@ -28,15 +28,15 @@ const builtinDoc = {
         "unit": "builtins::array::creation::true_false::tests",
         "integration": null
     },
-    "description": "`false` creates logical arrays filled with false values. Scalar, vector, matrix, and N-D sizing forms follow MATLAB semantics.",
+    "description": "`false` creates logical arrays filled with false values. MATLAB-compatible mode accepts scalar dimensions, multiple scalar dimensions, a row size vector, and `'like'`. Integer dimensions are read exactly, negative dimensions become zero, and trailing singleton dimensions are normalized according to MATLAB array-shape rules.",
     "behaviors": [
         "`false()` returns the scalar logical `false`.",
         "`false(n)` returns an n x n logical array of false values.",
         "`false(m, n, ...)` returns a logical array with the requested dimensions.",
-        "`false(sz)` accepts a size vector (row or column) and returns an array with prod(sz) elements arranged using MATLAB column-major ordering.",
-        "`false(A)` returns a logical array of false with the same size as `A`.",
-        "`false(___, 'like', prototype)` uses the prototype only for sizing; the result is still a host logical array.",
-        "`false(___, 'logical')` is accepted for MATLAB compatibility and has no effect."
+        "`false(sz)` accepts one row size vector. A column vector or multiple vector size inputs are rejected.",
+        "All eight integer classes are exact size controls. Negative signed dimensions become zero; noninteger, nonfinite, or platform-unrepresentable dimensions reject before allocation.",
+        "`false(___, 'like', prototype)` preserves applicable sparsity or owning-provider residency while the result remains logical. The prototype never supplies output shape, so `false('like', prototype)` is 1 × 1.",
+        "`false(A)`, the `'logical'` class option, single-precision size controls, and resident size controls are independently gated RunMat extensions rather than MATLAB-compatible syntax. An admitted resident size control is gathered structurally and still produces host logical output unless residency is requested explicitly with `'like'`."
     ],
     "examples": [
         {
@@ -50,8 +50,8 @@ const builtinDoc = {
             "output": "mask =\n  1x4x2 logical array\n     0     0     0     0\n     0     0     0     0"
         },
         {
-            "description": "Creating a false mask with the same size as an existing array",
-            "input": "A = rand(2, 2);\nmask = false(A)",
+            "description": "Creating a false mask with the same size and residency as an existing array",
+            "input": "A = rand(2, 2);\nmask = false(size(A), 'like', A)",
             "output": "mask =\n  2x2 logical array\n     0     0\n     0     0"
         }
     ],
@@ -66,15 +66,15 @@ const builtinDoc = {
         },
         {
             "question": "How does `false(sz)` interpret a size vector?",
-            "answer": "A row or column vector is treated as the full set of dimensions, so `false([2 3 4])` yields a 2x3x4 logical array."
+            "answer": "A row vector is treated as the full set of dimensions, so `false([2 3 4])` yields a 2x3x4 logical array. Column vectors and multiple vector inputs are rejected."
         },
         {
             "question": "Does `false` keep results on the GPU?",
-            "answer": "No. The builtin always returns a host logical array. gpuArray inputs are only used to infer the output size."
+            "answer": "Yes, when residency is requested explicitly with `'like'`. RunMat constructs the logical result through the prototype handle's owning provider; a GPU value supplied as an ordinary size control does not implicitly determine shape and residency at once."
         },
         {
             "question": "Is the `'logical'` option required?",
-            "answer": "No. `false` always returns logical values; the `'logical'` option is accepted only for MATLAB compatibility."
+            "answer": "No. `false` always returns logical values. RunMat retains the redundant `'logical'` spelling only in extension mode."
         }
     ],
     "links": [

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

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

package/dist/generated/builtins/fastTextWordEmbedding.js

@@ -38,7 +38,7 @@ const builtinDoc = {
     ],
     "examples": [
         {
-            "description": "Create The Compatibility Model",
+            "description": "Creating a word embedding model",
             "input": "emb = fastTextWordEmbedding",
             "output": "`emb.Dimension` is 300."
         },

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

@@ -1 +1 @@
-{"version":3,"file":"fastTextWordEmbedding.js","sourceRoot":"","sources":["../../../src/generated/builtins/fastTextWordEmbedding.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,uBAAuB;IAChC,UAAU,EAAE,wBAAwB;IACpC,UAAU,EAAE;QACV,uBAAuB;QACvB,eAAe;QACf,gBAAgB;QAChB,UAAU;QACV,YAAY;KACb;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,sDAAsD;QAC9D,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,+IAA+I;IAC9J,WAAW,EAAE;QACX,6EAA6E;QAC7E,kLAAkL;QAClL,6IAA6I;QAC7I,yLAAyL;KAC1L;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,6BAA6B;YACtC,QAAQ,EAAE,yBAAyB;SACpC;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,gJAAgJ;YACzJ,QAAQ,EAAE,uDAAuD;SAClE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6EAA6E;YACzF,QAAQ,EAAE,yKAAyK;SACpL;QACD;YACE,UAAU,EAAE,yEAAyE;YACrF,QAAQ,EAAE,+HAA+H;SAC1I;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,+DAA+D;SAC1E;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,qBAAqB;SAC7B;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,sBAAsB;SAC9B;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,6BAA6B;YACtC,QAAQ,EAAE,kDAAkD;SAC7D;QACD,QAAQ,EAAE;YACR,kCAAkC;YAClC,6DAA6D;YAC7D,uDAAuD;SACxD;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2EAA2E;QACpF,KAAK,EAAE,wHAAwH;KAChI;IACD,eAAe,EAAE,uFAAuF;IACxG,KAAK,EAAE,uBAAuB;IAC9B,MAAM,EAAE,uBAAuB;IAC/B,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,gBAAgB;KACjB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"fastTextWordEmbedding.js","sourceRoot":"","sources":["../../../src/generated/builtins/fastTextWordEmbedding.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,uBAAuB;IAChC,UAAU,EAAE,wBAAwB;IACpC,UAAU,EAAE;QACV,uBAAuB;QACvB,eAAe;QACf,gBAAgB;QAChB,UAAU;QACV,YAAY;KACb;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,sDAAsD;QAC9D,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,+IAA+I;IAC9J,WAAW,EAAE;QACX,6EAA6E;QAC7E,kLAAkL;QAClL,6IAA6I;QAC7I,yLAAyL;KAC1L;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,6BAA6B;YACtC,QAAQ,EAAE,yBAAyB;SACpC;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,gJAAgJ;YACzJ,QAAQ,EAAE,uDAAuD;SAClE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6EAA6E;YACzF,QAAQ,EAAE,yKAAyK;SACpL;QACD;YACE,UAAU,EAAE,yEAAyE;YACrF,QAAQ,EAAE,+HAA+H;SAC1I;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,+DAA+D;SAC1E;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,qBAAqB;SAC7B;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,sBAAsB;SAC9B;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,6BAA6B;YACtC,QAAQ,EAAE,kDAAkD;SAC7D;QACD,QAAQ,EAAE;YACR,kCAAkC;YAClC,6DAA6D;YAC7D,uDAAuD;SACxD;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2EAA2E;QACpF,KAAK,EAAE,wHAAwH;KAChI;IACD,eAAe,EAAE,uFAAuF;IACxG,KAAK,EAAE,uBAAuB;IAC9B,MAAM,EAAE,uBAAuB;IAC/B,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,gBAAgB;KACjB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/fclose.js

@@ -16,7 +16,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Runs entirely on the CPU. Arguments residing on the GPU are gathered automatically; file handles live on the host."
+        "notes": "Runs entirely on the CPU because file handles live in the host registry. Resident numeric identifiers are accepted only in RunMat extension mode and are gathered after compatibility preflight."
     },
     "fusion": {
         "elementwise": false,
@@ -29,12 +29,12 @@ const builtinDoc = {
         "unit": "builtins::io::filetext::fclose::tests",
         "integration": "builtins::io::filetext::fclose::tests::fclose_all_closes_everything"
     },
-    "description": "`fclose` closes files previously opened with `fopen`. Pass a file identifier, a vector of identifiers, or `'all'` (or no arguments) to close handles. Status and optional message outputs, including invalid-identifier behavior, follow MATLAB semantics.",
+    "description": "`fclose` closes files previously opened with `fopen`. MATLAB-compatible mode accepts one scalar double file identifier or the character vector `'all'` and returns at most one double status. RunMat's collection, typed-integer, logical, string, resident, no-input, and diagnostic-message forms are separately gated extensions.",
     "behaviors": [
         "`status = fclose(fid)` closes the file represented by the numeric identifier `fid`. The status is `0` on success and `-1` if the identifier is invalid.",
-        "`status = fclose([fid1 fid2 ...])` closes a vector of identifiers. If any identifier is invalid, status is `-1` and `message` explains the failure.",
-        "`status = fclose('all')` (or `fclose()` with no arguments) closes every open file except the standard streams (0, 1, 2).",
-        "`[status, message] = fclose(...)` returns the diagnostic message. On success, `message` is an empty character vector.",
+        "`status = fclose('all')` closes every open file except the standard streams (0, 1, 2). The documented keyword is a character vector.",
+        "The file identifier must be a finite, integer-valued scalar double in MATLAB-compatible mode. RunMat validates the complete request before performing a close.",
+        "Typed integer identifiers, identifier collections, logical identifiers, string-scalar `'all'`, resident identifiers, `fclose()` with no input, and `[status, message]` are available only when their RunMat extensions are enabled.",
         "Identifiers 0, 1, and 2 refer to standard input, output, and error. `fclose` treats them as already-open handles and simply returns success.",
         "RunMat keeps file metadata in a registry shared with `fopen`, ensuring MATLAB-compatible behaviour across subsequent I/O builtins."
     ],
@@ -51,33 +51,18 @@ const builtinDoc = {
         },
         {
             "description": "Handle invalid file identifiers gracefully",
-            "input": "[status, message] = fclose(9999);\nif status == -1\n    fprintf('Close failed: %s\\n', message);\nend",
-            "output": "status = -1;\nmessage = 'Invalid file identifier. Use fopen to generate a valid file ID.'"
-        },
-        {
-            "description": "Close multiple file identifiers together",
-            "input": "fids = fopen('all');\nstatus = fclose(fids)",
-            "output": "status = 0"
-        },
-        {
-            "description": "Detect failures with the second output",
-            "input": "[fid, msg] = fopen('data.bin', 'r');\nassert(fid ~= -1, msg);\nfclose(fid);\n[status, message] = fclose(fid);  % closes again, returns -1 and an error string",
-            "output": "status = -1;\nmessage = 'Invalid file identifier. Use fopen to generate a valid file ID.'"
-        },
-        {
-            "description": "Close files using the no-argument form",
-            "input": "% Equivalent to fclose('all')\nstatus = fclose()",
-            "output": "status = 0"
+            "input": "status = fclose(9999);\nif status == -1\n    fprintf('Close failed\\n');\nend",
+            "output": "status = -1"
         }
     ],
     "faqs": [
         {
             "question": "What values can I pass to `fclose`?",
-            "answer": "Pass a numeric file identifier (scalar or array) returned by `fopen`, or the keyword `'all'`. Calling `fclose()` with no arguments is equivalent to `fclose('all')`."
+            "answer": "For MATLAB-compatible code, pass one scalar double identifier returned by `fopen`, or the character vector `'all'`. Other accepted RunMat forms are explicit extensions."
         },
         {
             "question": "What does the status code mean?",
-            "answer": "`0` indicates that every requested identifier was successfully processed. `-1` means that at least one identifier was invalid; the optional second output contains the diagnostic message."
+            "answer": "`0` indicates success and `-1` indicates failure. MATLAB-compatible mode exposes that single status output; RunMat's diagnostic second output is extension-gated."
         },
         {
             "question": "Does `fclose` close standard input/output?",
@@ -143,7 +128,7 @@ const builtinDoc = {
         "url": "crates/runmat-runtime/src/builtins/io/filetext/fclose.rs"
     },
     "gpu_behavior": [
-        "`fclose` does not perform GPU computation. If the argument resides on a GPU array (for example, `'all'` stored in a `gpuArray`), RunMat gathers the value to host memory before dispatching the host-only close logic."
+        "`fclose` does not perform GPU computation. A resident numeric identifier is rejected before provider lookup in MATLAB-compatible mode. With the resident-fileID extension enabled, RunMat gathers it through its owning provider and then dispatches the host-only close logic."
     ],
     "key": "fclose",
     "slug": "fclose",

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

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

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

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

package/dist/generated/builtins/fcontour.js

@@ -34,13 +34,28 @@ const builtinDoc = {
         "`fcontour(f)` samples `f(x,y)` on the default `[-5 5 -5 5]` domain.",
         "`fcontour(f, [xmin xmax ymin ymax])` uses an explicit rectangular domain; a two-element vector applies the same limits to both axes.",
         "`fcontour(ax, ___)` renders into the requested axes and returns a function-contour graphics handle.",
-        "Function-handle outputs must be scalar real numeric values at every sampled point; non-finite samples are preserved as contour discontinuities."
+        "Function-handle outputs must be scalar real numeric values at every sampled point; non-finite samples are preserved as contour discontinuities.",
+        "Typed integer domain vectors, property scalars, and documented level vectors are accepted for all eight integer classes."
     ],
     "options": [
-        "`'MeshDensity'` controls the number of samples along each domain dimension. RunMat accepts integer values from 2 through 400.",
-        "`'LevelList'`, `'Levels'`, `'LevelStep'`, `'LevelListMode'`, `'LineColor'`, `'Color'`, and `'LineWidth'` use the same parsing path as `contour`.",
+        "`'MeshDensity'` controls the number of samples along each domain dimension. RunMat accepts exact integer counts from 3 through the resource ceiling of 400.",
+        "`'LevelList'` accepts a nonempty real numeric row or column vector. An integer scalar selects one explicit level, and descending level order is accepted.",
+        "`'LevelStep'` accepts a nonnegative finite real numeric scalar. Zero selects automatic levels and a positive integer crosses one checked contour-geometry conversion boundary.",
+        "`'LineWidth'` accepts a positive finite real numeric scalar and crosses one checked renderer-property conversion boundary.",
+        "`'Fill'` accepts logical values or the exact numeric scalar values zero and one. One adds filled contour bands beneath the contour lines.",
+        "`'LineColor'` accepts the documented text forms. Typed-integer RGB is a separately gated RunMat extension; the undocumented `'Color'` alias is not accepted by `fcontour`.",
         "`'DisplayName'` sets the function-contour graphics handle display name."
     ],
+    "integer_semantics": [
+        "`xyinterval` must be a two- or four-element row or column vector. Bounds are validated before the deliberate binary64 graphics-domain conversion.",
+        "All eight built-in integer classes are accepted for `xyinterval`, `MeshDensity`, `LevelList`, `LevelStep`, `LineWidth`, and numeric `Fill`.",
+        "Typed-integer `LineColor` and contour-style positional integer level specifications are RunMat extensions and are rejected unless RunMat extension mode is enabled.",
+        "Resident numeric arguments are also a RunMat extension; the compatibility gate runs before provider gathering."
+    ],
+    "compatibility_notes": [
+        "RunMat currently invokes the callback once per sampled point. First-class function-contour object fidelity, matrix callback evaluation, symbolic expressions, and adaptive sampling remain deferred broader compatibility work.",
+        "The RunMat-only positional level shorthand is not part of the documented `fcontour` compatibility surface. Use `LevelList` or `LevelStep` for portable code."
+    ],
     "examples": [
         {
             "description": "Plot function contours over the default domain",

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

@@ -1 +1 @@
-{"version":3,"file":"fcontour.js","sourceRoot":"","sources":["../../../src/generated/builtins/fcontour.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,UAAU;QACV,kBAAkB;QAClB,cAAc;QACd,iBAAiB;KAClB;IACD,SAAS,EAAE,0CAA0C;IACrD,YAAY,EAAE,4EAA4E;IAC1F,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,6LAA6L;KACvM;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,mFAAmF;KACnG;IACD,aAAa,EAAE,kIAAkI;IACjJ,WAAW,EAAE;QACX,qEAAqE;QACrE,sIAAsI;QACtI,qGAAqG;QACrG,iJAAiJ;KAClJ;IACD,SAAS,EAAE;QACT,+HAA+H;QAC/H,kJAAkJ;QAClJ,yEAAyE;KAC1E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,mCAAmC;SAC7C;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,0FAA0F;SACpG;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,0DAA0D;YACtE,QAAQ,EAAE,0JAA0J;SACrK;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,6GAA6G;SACxH;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,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,eAAe,EAAE,8MAA8M;IAC/N,cAAc,EAAE;QACd,qCAAqC;QACrC,+EAA+E;KAChF;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"fcontour.js","sourceRoot":"","sources":["../../../src/generated/builtins/fcontour.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,UAAU;QACV,kBAAkB;QAClB,cAAc;QACd,iBAAiB;KAClB;IACD,SAAS,EAAE,0CAA0C;IACrD,YAAY,EAAE,4EAA4E;IAC1F,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,6LAA6L;KACvM;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,mFAAmF;KACnG;IACD,aAAa,EAAE,kIAAkI;IACjJ,WAAW,EAAE;QACX,qEAAqE;QACrE,sIAAsI;QACtI,qGAAqG;QACrG,iJAAiJ;QACjJ,0HAA0H;KAC3H;IACD,SAAS,EAAE;QACT,6JAA6J;QAC7J,2JAA2J;QAC3J,gLAAgL;QAChL,4HAA4H;QAC5H,2IAA2I;QAC3I,4KAA4K;QAC5K,yEAAyE;KAC1E;IACD,mBAAmB,EAAE;QACnB,mJAAmJ;QACnJ,6IAA6I;QAC7I,qKAAqK;QACrK,gHAAgH;KACjH;IACD,qBAAqB,EAAE;QACrB,iOAAiO;QACjO,8JAA8J;KAC/J;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,mCAAmC;SAC7C;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,0FAA0F;SACpG;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,0DAA0D;YACtE,QAAQ,EAAE,0JAA0J;SACrK;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,6GAA6G;SACxH;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,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,eAAe,EAAE,8MAA8M;IAC/N,cAAc,EAAE;QACd,qCAAqC;QACrC,+EAA+E;KAChF;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/fea.boundaryCondition.d.ts

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

package/dist/generated/builtins/fea.boundaryCondition.d.ts.map

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

package/dist/generated/builtins/fea.boundaryCondition.js

@@ -0,0 +1,71 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "fea.boundaryCondition",
+    "category": "fea",
+    "keywords": [
+        "fea",
+        "boundary condition",
+        "thermal",
+        "acoustic",
+        "cfd"
+    ],
+    "summary": "Create a typed RunMat FEA boundary condition.",
+    "requires_feature": "fea",
+    "tested": {
+        "unit": "builtins::fea::tests::fea_boundary_condition"
+    },
+    "description": "`fea.boundaryCondition(id, region, kind, Name, Value, ...)` creates a typed boundary-condition object for a RunMat FEA model. This API is native to RunMat rather than a MATLAB compatibility builtin.",
+    "behaviors": [
+        "The first three inputs select the boundary-condition id, target region id, and boundary kind.",
+        "Numeric fields must be finite real numeric scalars. Logical values, arrays with more than one element, and unknown fields are rejected with `RunMat:fea:InvalidInput`.",
+        "All eight built-in integer classes are accepted for every numeric field listed below. Each exact integer is converted once to the model's binary64 field using IEEE-754 integer-to-f64 conversion, so sufficiently wide integers can round."
+    ],
+    "integer_forms": [
+        "`prescribedRotation`: `rx`, `ry`, and `rz`.",
+        "`acousticImpedance`: `specificImpedancePaSPerM`.",
+        "`thermalPrescribedTemperature`: `temperatureK`.",
+        "`thermalHeatFlux`: `heatFluxWPerM2`.",
+        "`thermalConvection`: `ambientTemperatureK` and `coefficientWPerM2K`.",
+        "`cfdInletVelocity`: `velocityMPerS`.",
+        "`cfdOutletPressure`: `pressurePa`."
+    ],
+    "examples": [
+        {
+            "description": "Prescribe integer-valued rotations",
+            "input": "bc = fea.boundaryCondition('rotation', 'tip', 'prescribedRotation', 'rx', int16(0), 'ry', int16(1), 'rz', int16(0));"
+        },
+        {
+            "description": "Create a CFD inlet boundary",
+            "input": "bc = fea.boundaryCondition('inlet', 'inlet_face', 'cfdInletVelocity', 'velocityMPerS', uint8(12));"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Are integer fields stored as integers?",
+            "answer": "No. Boundary-condition model fields are binary64 values. RunMat preserves the integer until the explicit constructor boundary and then performs one documented IEEE-754 conversion."
+        }
+    ],
+    "links": [
+        {
+            "label": "Using FEA",
+            "url": "../../fea/using-fea"
+        },
+        {
+            "label": "FEA operation reference",
+            "url": "../../fea/operation-reference"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/fea/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/fea/mod.rs"
+    },
+    "key": "fea.boundarycondition",
+    "slug": "fea.boundarycondition",
+    "aliases": [],
+    "categoryPath": [
+        "fea"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=fea.boundaryCondition.js.map

package/dist/generated/builtins/fea.boundaryCondition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fea.boundaryCondition.js","sourceRoot":"","sources":["../../../src/generated/builtins/fea.boundaryCondition.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,uBAAuB;IAChC,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE;QACV,KAAK;QACL,oBAAoB;QACpB,SAAS;QACT,UAAU;QACV,KAAK;KACN;IACD,SAAS,EAAE,+CAA+C;IAC1D,kBAAkB,EAAE,KAAK;IACzB,QAAQ,EAAE;QACR,MAAM,EAAE,8CAA8C;KACvD;IACD,aAAa,EAAE,wMAAwM;IACvN,WAAW,EAAE;QACX,+FAA+F;QAC/F,wKAAwK;QACxK,6OAA6O;KAC9O;IACD,eAAe,EAAE;QACf,6CAA6C;QAC7C,kDAAkD;QAClD,iDAAiD;QACjD,sCAAsC;QACtC,sEAAsE;QACtE,sCAAsC;QACtC,oCAAoC;KACrC;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,sHAAsH;SAChI;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,oGAAoG;SAC9G;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,qLAAqL;SAChM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,qBAAqB;SAC7B;QACD;YACE,OAAO,EAAE,yBAAyB;YAClC,KAAK,EAAE,+BAA+B;SACvC;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iDAAiD;QAC1D,KAAK,EAAE,8FAA8F;KACtG;IACD,KAAK,EAAE,uBAAuB;IAC9B,MAAM,EAAE,uBAAuB;IAC/B,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/fea.compare.d.ts

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

package/dist/generated/builtins/fea.compare.d.ts.map

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

package/dist/generated/builtins/fea.compare.js

@@ -0,0 +1,55 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "fea.compare",
+    "category": "fea",
+    "keywords": [
+        "fea",
+        "compare",
+        "results",
+        "quality"
+    ],
+    "summary": "Compare two persisted RunMat FEA runs.",
+    "requires_feature": "fea",
+    "tested": {
+        "unit": "builtins::fea::tests",
+        "integration": null
+    },
+    "description": "`fea.compare(baselineRunId, candidateRunId)` compares summary, status, quality, iteration, and timing evidence for two persisted RunMat FEA runs. This is a native RunMat API.",
+    "behaviors": [
+        "Exactly two text run identifiers are required; `fea.compare` does not accept Name, Value options.",
+        "Both run identifiers are resolved before the results-comparison operation executes.",
+        "Count and count-delta fields are structural signed integers. Timing deltas remain binary64 physical measurements.",
+        "Numeric and resident numeric inputs have no role and are rejected before artifact-store access."
+    ],
+    "examples": [
+        {
+            "description": "Compare two persisted runs",
+            "input": "comparison = fea.compare(\"run_baseline\", \"run_candidate\");"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Can comparison options follow the run identifiers?",
+            "answer": "No. The current builtin accepts exactly two run identifiers and no options."
+        }
+    ],
+    "links": [
+        {
+            "label": "FEA operation reference",
+            "url": "../../fea/operation-reference"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/fea/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/fea/mod.rs"
+    },
+    "key": "fea.compare",
+    "slug": "fea.compare",
+    "aliases": [],
+    "categoryPath": [
+        "fea"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=fea.compare.js.map

package/dist/generated/builtins/fea.compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fea.compare.js","sourceRoot":"","sources":["../../../src/generated/builtins/fea.compare.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE;QACV,KAAK;QACL,SAAS;QACT,SAAS;QACT,SAAS;KACV;IACD,SAAS,EAAE,wCAAwC;IACnD,kBAAkB,EAAE,KAAK;IACzB,QAAQ,EAAE;QACR,MAAM,EAAE,sBAAsB;QAC9B,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,gLAAgL;IAC/L,WAAW,EAAE;QACX,mGAAmG;QACnG,qFAAqF;QACrF,mHAAmH;QACnH,iGAAiG;KAClG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,gEAAgE;SAC1E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,6EAA6E;SACxF;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,yBAAyB;YAClC,KAAK,EAAE,+BAA+B;SACvC;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iDAAiD;QAC1D,KAAK,EAAE,8FAA8F;KACtG;IACD,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/fea.domain.d.ts

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

package/dist/generated/builtins/fea.domain.d.ts.map

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

package/dist/generated/builtins/fea.domain.js

@@ -0,0 +1,63 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "fea.domain",
+    "category": "fea",
+    "keywords": [
+        "fea",
+        "domain",
+        "thermal",
+        "electromagnetic",
+        "cfd"
+    ],
+    "summary": "Create a typed RunMat FEA physics domain.",
+    "requires_feature": "fea",
+    "tested": {
+        "unit": "builtins::fea::tests",
+        "integration": null
+    },
+    "description": "`fea.domain(kind, Name, Value, ...)` creates thermo-mechanical, electro-thermal, electromagnetic, or CFD domain data for a RunMat FEA model.",
+    "behaviors": [
+        "The domain kind selects the supported field set; unknown fields are rejected before object construction.",
+        "Finite real numeric physical fields accept all eight built-in integer classes. Exact integer values are retained until one host-only binary64 model-storage conversion, so sufficiently wide integers can round.",
+        "A nested thermo-field-source `revision` is a structural nonnegative integer and remains exact rather than crossing the physical-value binary64 boundary.",
+        "Resident numeric fields are rejected because domain construction does not perform provider execution."
+    ],
+    "integer_forms": [
+        "Thermo-mechanical physical fields, including reference temperature, applied temperature delta, region temperature deltas, and time-profile coordinates/scales.",
+        "Electro-thermal physical fields, including reference temperature, applied voltage, conductivity scales, and time-profile coordinates/scales.",
+        "Electromagnetic reference frequency and applied current.",
+        "CFD density, viscosity, inlet velocity, turbulence intensity, and time-profile coordinates/scales.",
+        "Thermo field-source revision is structural and exact."
+    ],
+    "examples": [
+        {
+            "description": "Create a CFD domain",
+            "input": "domain = fea.domain(\"cfd\", \"ReferenceDensityKgPerM3\", uint16(1), \"InletVelocityMPerS\", int16(12));"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `revision` become binary64?",
+            "answer": "No. Revision is structural model identity and is validated and stored as an exact nonnegative integer."
+        }
+    ],
+    "links": [
+        {
+            "label": "Using FEA",
+            "url": "../../fea/using-fea"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/fea/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/fea/mod.rs"
+    },
+    "key": "fea.domain",
+    "slug": "fea.domain",
+    "aliases": [],
+    "categoryPath": [
+        "fea"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=fea.domain.js.map

package/dist/generated/builtins/fea.domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fea.domain.js","sourceRoot":"","sources":["../../../src/generated/builtins/fea.domain.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE;QACV,KAAK;QACL,QAAQ;QACR,SAAS;QACT,iBAAiB;QACjB,KAAK;KACN;IACD,SAAS,EAAE,2CAA2C;IACtD,kBAAkB,EAAE,KAAK;IACzB,QAAQ,EAAE;QACR,MAAM,EAAE,sBAAsB;QAC9B,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,8IAA8I;IAC7J,WAAW,EAAE;QACX,0GAA0G;QAC1G,kNAAkN;QAClN,0JAA0J;QAC1J,uGAAuG;KACxG;IACD,eAAe,EAAE;QACf,gKAAgK;QAChK,8IAA8I;QAC9I,0DAA0D;QAC1D,oGAAoG;QACpG,uDAAuD;KACxD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,0GAA0G;SACpH;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,wGAAwG;SACnH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,qBAAqB;SAC7B;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iDAAiD;QAC1D,KAAK,EAAE,8FAA8F;KACtG;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/fea.field.d.ts

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

package/dist/generated/builtins/fea.field.d.ts.map

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

package/dist/generated/builtins/fea.field.js

@@ -0,0 +1,56 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "fea.field",
+    "category": "fea",
+    "keywords": [
+        "fea",
+        "field",
+        "results",
+        "post-processing"
+    ],
+    "summary": "Extract one field from RunMat FEA results.",
+    "requires_feature": "fea",
+    "tested": {
+        "unit": "builtins::fea::tests::fea_results_field",
+        "integration": null
+    },
+    "description": "`fea.field(resultsOrRun, fieldId)` resolves one named field from a RunMat FEA result object and returns a typed `fea.Field` object.",
+    "behaviors": [
+        "Exactly one result or run object and one text field identifier are required.",
+        "An exact field id wins; a unique dotted-name suffix is also accepted, while absent or ambiguous fields fail.",
+        "Host field values are exposed as binary64 tensors. A device field reference remains provider metadata and is not silently gathered.",
+        "Shape, component-count, element-count, and size metadata are structural integer outputs and remain integer typed; they are not physical field values.",
+        "Integer input arrays have no role and are rejected before result lookup."
+    ],
+    "examples": [
+        {
+            "description": "Extract stress results",
+            "input": "stress = fea.field(results, \"structural.von_mises\");"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Are shape and element count field data?",
+            "answer": "No. They are exact structural metadata; the `values` property contains the binary64 physical field data."
+        }
+    ],
+    "links": [
+        {
+            "label": "Using FEA",
+            "url": "../../fea/using-fea"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/fea/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/fea/mod.rs"
+    },
+    "key": "fea.field",
+    "slug": "fea.field",
+    "aliases": [],
+    "categoryPath": [
+        "fea"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=fea.field.js.map

package/dist/generated/builtins/fea.field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fea.field.js","sourceRoot":"","sources":["../../../src/generated/builtins/fea.field.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE;QACV,KAAK;QACL,OAAO;QACP,SAAS;QACT,iBAAiB;KAClB;IACD,SAAS,EAAE,4CAA4C;IACvD,kBAAkB,EAAE,KAAK;IACzB,QAAQ,EAAE;QACR,MAAM,EAAE,yCAAyC;QACjD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,qIAAqI;IACpJ,WAAW,EAAE;QACX,8EAA8E;QAC9E,8GAA8G;QAC9G,qIAAqI;QACrI,uJAAuJ;QACvJ,0EAA0E;KAC3E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,wDAAwD;SAClE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,0GAA0G;SACrH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,qBAAqB;SAC7B;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iDAAiD;QAC1D,KAAK,EAAE,8FAA8F;KACtG;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/fea.interface.d.ts

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

package/dist/generated/builtins/fea.interface.d.ts.map

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