runmat 0.3.5 → 0.4.0

package/dist/generated/builtins/tril.js

@@ -0,0 +1,186 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "tril",
+    "category": "array/shape",
+    "keywords": [
+        "tril",
+        "lower triangular",
+        "matrix",
+        "diagonal",
+        "gpu"
+    ],
+    "summary": "Extract the lower triangular portion of a matrix (optionally including super-diagonals).",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "Uses provider tril kernels when available; otherwise gathers once, computes on the host, and re-uploads to keep results gpu-resident."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::array::shape::tril::tests",
+        "integration": "builtins::array::shape::tril::tests::tril_gpu_roundtrip"
+    },
+    "description": "`tril(A)` keeps the elements on and below a selected diagonal of `A` and sets everything above that diagonal to zero. The optional second argument `k` controls which diagonal is retained:\n\n- `k = 0` (default) keeps the main diagonal. - `k > 0` includes super-diagonals above the main diagonal. - `k < 0` drops the main diagonal and starts below it.\n\nThe operation applies independently to every matrix \"page\" of N-D tensors.",
+    "behaviors": [
+        "Works on numeric, logical, and complex arrays.",
+        "Operates on the first two dimensions; trailing dimensions are handled as independent pages.",
+        "Accepts scalar, vector, matrix, or paged inputs of any size, including empty dimensions.",
+        "Logical inputs remain logical, and complex values keep their real/imaginary components.",
+        "Scalars are treated as `1×1` matrices and honour negative offsets (`k < 0` yields zero).",
+        "gpuArray inputs stay on the device when the provider exposes a native `tril` hook; otherwise RunMat performs a gather → compute → upload cycle."
+    ],
+    "examples": [
+        {
+            "description": "Extracting the lower triangular part of a matrix",
+            "input": "A = [1 2 3; 4 5 6; 7 8 9];\nL = tril(A)",
+            "output": "L =\n     1     0     0\n     4     5     0\n     7     8     9"
+        },
+        {
+            "description": "Keeping one super-diagonal above the main diagonal",
+            "input": "A = magic(4);\nL = tril(A, 1)",
+            "output": "L =\n    16     2     0     0\n     5    11    10     0\n     9     7     6    12\n     4    14    15     1"
+        },
+        {
+            "description": "Dropping the main diagonal with a negative offset",
+            "input": "A = [1 2 3; 4 5 6; 7 8 9];\nstrict = tril(A, -1)",
+            "output": "strict =\n     0     0     0\n     4     0     0\n     7     8     0"
+        },
+        {
+            "description": "Applying `tril` to every page of a 3-D array",
+            "input": "T = reshape(1:18, [3 3 2]);\nL = tril(T)",
+            "output": "L(:, :, 1) =\n     1     0     0\n     4     5     0\n     7     8     9\n\nL(:, :, 2) =\n    10     0     0\n    13    14     0\n    16    17    18"
+        },
+        {
+            "description": "Preserving gpuArray residency with `tril`",
+            "input": "G = gpuArray(rand(5));\nL = tril(G, -2);\nisa(L, 'gpuArray')",
+            "output": "ans =\n  logical\n   1"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What happens when `k` is larger than the matrix size?",
+            "answer": "The entire matrix is preserved; `tril` never removes elements below the chosen diagonal."
+        },
+        {
+            "question": "Does `tril` work with logical arrays?",
+            "answer": "Yes. Elements above the retained diagonal become `false`, while the rest keep their logical values."
+        },
+        {
+            "question": "How are complex numbers handled?",
+            "answer": "Each element keeps its real and imaginary parts intact. Only the elements above the chosen diagonal are zeroed out (`0 + 0i`)."
+        },
+        {
+            "question": "What about empty matrices or zero-sized dimensions?",
+            "answer": "`tril` returns an array of the same shape, leaving all entries at zero. Trailing dimensions with size zero are treated as empty batches."
+        },
+        {
+            "question": "Does `tril` change the class of character arrays?",
+            "answer": "Character arrays are converted to their numeric codes (double precision) before the triangular mask is applied, matching MATLAB's behaviour."
+        }
+    ],
+    "links": [
+        {
+            "label": "`triu`",
+            "url": "./triu"
+        },
+        {
+            "label": "`diag`",
+            "url": "./diag"
+        },
+        {
+            "label": "`kron`",
+            "url": "./kron"
+        },
+        {
+            "label": "`reshape`",
+            "url": "./reshape"
+        },
+        {
+            "label": "`gpuArray`",
+            "url": "./gpuarray"
+        },
+        {
+            "label": "`gather`",
+            "url": "./gather"
+        },
+        {
+            "label": "cat",
+            "url": "./cat"
+        },
+        {
+            "label": "circshift",
+            "url": "./circshift"
+        },
+        {
+            "label": "flip",
+            "url": "./flip"
+        },
+        {
+            "label": "fliplr",
+            "url": "./fliplr"
+        },
+        {
+            "label": "flipud",
+            "url": "./flipud"
+        },
+        {
+            "label": "horzcat",
+            "url": "./horzcat"
+        },
+        {
+            "label": "ipermute",
+            "url": "./ipermute"
+        },
+        {
+            "label": "permute",
+            "url": "./permute"
+        },
+        {
+            "label": "repmat",
+            "url": "./repmat"
+        },
+        {
+            "label": "rot90",
+            "url": "./rot90"
+        },
+        {
+            "label": "squeeze",
+            "url": "./squeeze"
+        },
+        {
+            "label": "vertcat",
+            "url": "./vertcat"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/array/shape/tril.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/array/shape/tril.rs"
+    },
+    "gpu_residency": "```matlab:runnable\nG = gpuArray(rand(5));\nL = tril(G, -2);\nisa(L, 'gpuArray')\n```\nExpected output:\n```matlab\nans =\n  logical\n   1\n```",
+    "gpu_behavior": [
+        "If the active acceleration provider implements the custom `tril` hook the entire operation runs on the GPU.",
+        "When the hook is missing, RunMat gathers the data once, computes the result on the host, uploads the lower triangular tensor back to the device, and returns a gpuArray handle so residency is preserved for downstream kernels.",
+        "Falling back to the host never changes numerical results; it only affects where the computation is carried out."
+    ],
+    "key": "tril",
+    "slug": "tril",
+    "categoryPath": [
+        "array",
+        "shape"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=tril.js.map

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

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

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

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

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

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

package/dist/generated/builtins/triu.js

@@ -0,0 +1,185 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "triu",
+    "category": "array/shape",
+    "keywords": [
+        "triu",
+        "upper triangular",
+        "matrix",
+        "diagonal",
+        "gpu"
+    ],
+    "summary": "Keep the upper triangular portion of a matrix (optionally including sub-diagonals).",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "Uses provider triu kernels when available; otherwise gathers once, masks on the host, and re-uploads so results remain gpu-resident."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::array::shape::triu::tests",
+        "integration": "builtins::array::shape::triu::tests::triu_gpu_roundtrip"
+    },
+    "description": "`triu(A)` keeps the elements on and above a selected diagonal of `A` and sets everything below that diagonal to zero. The optional second argument `k` controls which diagonal is retained:\n\n- `k = 0` (default) keeps the main diagonal. - `k > 0` keeps the diagonal `k` steps above the main diagonal (the main diagonal and everything below it become zero). - `k < 0` includes additional sub-diagonals beneath the main diagonal.\n\nEvery matrix \"page\" in an N-D tensor is processed independently.",
+    "behaviors": [
+        "Works on numeric, logical, and complex arrays.",
+        "Operates on the first two dimensions; trailing dimensions act as independent pages.",
+        "Preserves logical types and complex-valued elements.",
+        "Scalars are treated as `1×1` matrices and honour diagonal offsets (for example `triu(5, 1)` returns `0`).",
+        "gpuArray inputs stay on the device when an acceleration provider supplies a native `triu` hook; otherwise the runtime gathers, masks on the host, and uploads the result back to the GPU."
+    ],
+    "examples": [
+        {
+            "description": "Extracting the upper triangular part of a matrix",
+            "input": "A = [1 2 3; 4 5 6; 7 8 9];\nU = triu(A)",
+            "output": "U =\n     1     2     3\n     0     5     6\n     0     0     9"
+        },
+        {
+            "description": "Keeping one sub-diagonal beneath the main diagonal",
+            "input": "A = magic(4);\nU = triu(A, -1)",
+            "output": "U =\n    16     2     3     13\n     5    11    10     8\n     0     7     6    12\n     0     0    15     1"
+        },
+        {
+            "description": "Dropping the main diagonal with a positive offset",
+            "input": "A = [1 2 3; 4 5 6; 7 8 9];\nstrict = triu(A, 1)",
+            "output": "strict =\n     0     2     3\n     0     0     6\n     0     0     0"
+        },
+        {
+            "description": "Applying `triu` to every page of a 3-D array",
+            "input": "T = reshape(1:18, [3 3 2]);\nU = triu(T)",
+            "output": "U(:, :, 1) =\n     1     2     3\n     0     5     6\n     0     0     9\n\nU(:, :, 2) =\n    10    11    12\n     0    14    15\n     0     0    18"
+        },
+        {
+            "description": "Preserving gpuArray residency with `triu`",
+            "input": "G = gpuArray(rand(5));\nU = triu(G, -2);\nisa(U, 'gpuArray')",
+            "output": "ans =\n  logical\n   1"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What happens when `k` is smaller than the matrix size (large negative)?",
+            "answer": "The entire matrix is preserved; `triu` never removes elements above the chosen diagonal."
+        },
+        {
+            "question": "Does `triu` work with logical arrays?",
+            "answer": "Yes. Elements below the retained diagonal become `false`, while the rest keep their logical values."
+        },
+        {
+            "question": "How are complex numbers handled?",
+            "answer": "Each element retains its real and imaginary parts. Only elements below the chosen diagonal become `0 + 0i`."
+        },
+        {
+            "question": "What about empty matrices or zero-sized dimensions?",
+            "answer": "`triu` returns an array of the same shape, leaving all entries at zero. Trailing dimensions with size zero are treated as empty batches."
+        },
+        {
+            "question": "Does `triu` change the class of character arrays?",
+            "answer": "Character arrays are converted to their numeric codes (double precision) before the triangular mask is applied, matching MATLAB behaviour."
+        }
+    ],
+    "links": [
+        {
+            "label": "`tril`",
+            "url": "./tril"
+        },
+        {
+            "label": "`diag`",
+            "url": "./diag"
+        },
+        {
+            "label": "`kron`",
+            "url": "./kron"
+        },
+        {
+            "label": "`reshape`",
+            "url": "./reshape"
+        },
+        {
+            "label": "`gpuArray`",
+            "url": "./gpuarray"
+        },
+        {
+            "label": "`gather`",
+            "url": "./gather"
+        },
+        {
+            "label": "cat",
+            "url": "./cat"
+        },
+        {
+            "label": "circshift",
+            "url": "./circshift"
+        },
+        {
+            "label": "flip",
+            "url": "./flip"
+        },
+        {
+            "label": "fliplr",
+            "url": "./fliplr"
+        },
+        {
+            "label": "flipud",
+            "url": "./flipud"
+        },
+        {
+            "label": "horzcat",
+            "url": "./horzcat"
+        },
+        {
+            "label": "ipermute",
+            "url": "./ipermute"
+        },
+        {
+            "label": "permute",
+            "url": "./permute"
+        },
+        {
+            "label": "repmat",
+            "url": "./repmat"
+        },
+        {
+            "label": "rot90",
+            "url": "./rot90"
+        },
+        {
+            "label": "squeeze",
+            "url": "./squeeze"
+        },
+        {
+            "label": "vertcat",
+            "url": "./vertcat"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/array/shape/triu.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/array/shape/triu.rs"
+    },
+    "gpu_residency": "```matlab:runnable\nG = gpuArray(rand(5));\nU = triu(G, -2);\nisa(U, 'gpuArray')\n```\nExpected output:\n```matlab\nans =\n  logical\n   1\n```",
+    "gpu_behavior": [
+        "If the active acceleration provider implements a `triu` kernel the entire operation executes on the GPU.",
+        "Without a provider hook, RunMat gathers the tensor to host memory once, applies the mask, uploads the result, and returns a gpuArray so residency is preserved for downstream kernels.",
+        "Fallbacks never affect numerical results—only where the computation runs."
+    ],
+    "key": "triu",
+    "slug": "triu",
+    "categoryPath": [
+        "array",
+        "shape"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=triu.js.map

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

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

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

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

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

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

package/dist/generated/builtins/true.js

@@ -0,0 +1,163 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "true",
+    "category": "array/creation",
+    "keywords": [
+        "true",
+        "logical",
+        "array",
+        "mask"
+    ],
+    "summary": "Create logical arrays filled with true values.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Always constructs a host logical array; gpuArray inputs are used only for sizing."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::array::creation::true_false::tests",
+        "integration": null
+    },
+    "description": "`true` creates logical arrays filled with true values. RunMat mirrors MATLAB sizing semantics across scalar, vector, matrix, and N-D forms.",
+    "behaviors": [
+        "`true()` returns the scalar logical `true`.",
+        "`true(n)` returns an n x n logical array of true values.",
+        "`true(m, n, ...)` returns a logical array with the requested dimensions.",
+        "`true(sz)` accepts a size vector (row or column) and returns an array with prod(sz) elements arranged using MATLAB column-major ordering.",
+        "`true(A)` returns a logical array of true with the same size as `A`.",
+        "`true(___, 'like', prototype)` uses the prototype only for sizing; the result is still a host logical array.",
+        "`true(___, 'logical')` is accepted for MATLAB compatibility and has no effect."
+    ],
+    "examples": [
+        {
+            "description": "Creating a 2x3 logical array of true values",
+            "input": "mask = true(2, 3)",
+            "output": "mask = [1 1 1; 1 1 1]"
+        },
+        {
+            "description": "Creating a logical array from a size vector",
+            "input": "dims = [2 1 3];\nmask = true(dims)",
+            "output": "mask =\n  2x1x3 logical array\n     1\n     1\n     1\n     1\n     1\n     1"
+        },
+        {
+            "description": "Creating a true mask with the same size as an existing array",
+            "input": "A = rand(3, 2);\nmask = true(A)",
+            "output": "mask =\n  3x2 logical array\n     1     1\n     1     1\n     1     1"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What does `true()` return?",
+            "answer": "It returns the logical scalar `true`."
+        },
+        {
+            "question": "Does `true(n)` create a square array?",
+            "answer": "Yes. `true(n)` returns an n x n logical array of true values, matching MATLAB behavior."
+        },
+        {
+            "question": "How does `true(sz)` interpret a size vector?",
+            "answer": "A row or column vector is treated as the full set of dimensions, so `true([2 3 4])` yields a 2x3x4 logical array."
+        },
+        {
+            "question": "Does `true` 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."
+        },
+        {
+            "question": "Is the `'logical'` option required?",
+            "answer": "No. `true` always returns logical values; the `'logical'` option is accepted only for MATLAB compatibility."
+        }
+    ],
+    "links": [
+        {
+            "label": "false",
+            "url": "./false"
+        },
+        {
+            "label": "logical",
+            "url": "./logical"
+        },
+        {
+            "label": "islogical",
+            "url": "./islogical"
+        },
+        {
+            "label": "zeros",
+            "url": "./zeros"
+        },
+        {
+            "label": "colon",
+            "url": "./colon"
+        },
+        {
+            "label": "eye",
+            "url": "./eye"
+        },
+        {
+            "label": "fill",
+            "url": "./fill"
+        },
+        {
+            "label": "linspace",
+            "url": "./linspace"
+        },
+        {
+            "label": "logspace",
+            "url": "./logspace"
+        },
+        {
+            "label": "magic",
+            "url": "./magic"
+        },
+        {
+            "label": "meshgrid",
+            "url": "./meshgrid"
+        },
+        {
+            "label": "ones",
+            "url": "./ones"
+        },
+        {
+            "label": "rand",
+            "url": "./rand"
+        },
+        {
+            "label": "randi",
+            "url": "./randi"
+        },
+        {
+            "label": "randn",
+            "url": "./randn"
+        },
+        {
+            "label": "randperm",
+            "url": "./randperm"
+        },
+        {
+            "label": "range",
+            "url": "./range"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/array/creation/true_false.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/array/creation/true_false.rs"
+    },
+    "key": "true",
+    "slug": "true",
+    "categoryPath": [
+        "array",
+        "creation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=true.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"true.js","sourceRoot":"","sources":["../../../src/generated/builtins/true.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE;QACV,MAAM;QACN,SAAS;QACT,OAAO;QACP,MAAM;KACP;IACD,SAAS,EAAE,gDAAgD;IAC3D,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mFAAmF;KAC7F;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,6IAA6I;IAC5J,WAAW,EAAE;QACX,6CAA6C;QAC7C,0DAA0D;QAC1D,0EAA0E;QAC1E,2IAA2I;QAC3I,sEAAsE;QACtE,8GAA8G;QAC9G,gFAAgF;KACjF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,mBAAmB;YAC5B,QAAQ,EAAE,uBAAuB;SAClC;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,oCAAoC;YAC7C,QAAQ,EAAE,+EAA+E;SAC1F;QACD;YACE,aAAa,EAAE,8DAA8D;YAC7E,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,uEAAuE;SAClF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,uCAAuC;SAClD;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,yFAAyF;SACpG;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,mHAAmH;SAC9H;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,8GAA8G;SACzH;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,6GAA6G;SACxH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;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,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,cAAc,EAAE;QACd,OAAO;QACP,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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