runmat 0.5.7-dev.2 → 0.5.7-dev.4

package/dist/generated/builtins/padsequences.js

@@ -0,0 +1,50 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "padsequences",
+    "category": "deep_learning",
+    "keywords": [
+        "padsequences",
+        "deep learning",
+        "sequence",
+        "padding"
+    ],
+    "summary": "Pad or truncate numeric sequence cell arrays.",
+    "description": "`padsequences(sequences, paddingDim)` pads or truncates numeric sequences stored in a cell array along the requested dimension.",
+    "behaviors": [
+        "`sequences` must be a cell array of numeric scalar/vector/tensor sequences.",
+        "`paddingDim` is a required positive integer dimension.",
+        "`PaddingDirection` accepts `left`, `right`, or `both`; the default is `right`.",
+        "`Length` accepts `longest`, `shortest`, or a positive integer.",
+        "`PaddingValue` accepts a finite numeric scalar and defaults to `0`.",
+        "`UniformOutput` defaults to `true` and stacks padded sequences into a numeric tensor; `false` preserves the input cell shape."
+    ],
+    "examples": [
+        {
+            "description": "Right Pad Sequences",
+            "input": "Y = padsequences({[1 2], 3}, 2, 'PaddingValue', -1)",
+            "output": "A numeric tensor with right-padded row sequences."
+        },
+        {
+            "description": "Preserve Cell Shape",
+            "input": "C = padsequences({[1 2 3], [4 5]}, 2, 'Length', 2, 'PaddingDirection', 'left', 'UniformOutput', false)",
+            "output": "A cell array whose first sequence keeps the tail `[2 3]`."
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "Y = padsequences(sequences, paddingDim)\nY = padsequences(sequences, paddingDim, Name, Value)",
+            "output": "Numeric tensor by default, or cell array when `UniformOutput` is false."
+        }
+    },
+    "gpu_residency": "`padsequences` materializes host sequence tensors in this slice; provider-resident sequence padding remains future GPU work.",
+    "key": "padsequences",
+    "slug": "padsequences",
+    "aliases": [],
+    "categoryPath": [
+        "deep_learning"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=padsequences.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"padsequences.js","sourceRoot":"","sources":["../../../src/generated/builtins/padsequences.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,cAAc;QACd,eAAe;QACf,UAAU;QACV,SAAS;KACV;IACD,SAAS,EAAE,+CAA+C;IAC1D,aAAa,EAAE,iIAAiI;IAChJ,WAAW,EAAE;QACX,6EAA6E;QAC7E,wDAAwD;QACxD,gFAAgF;QAChF,gEAAgE;QAChE,qEAAqE;QACrE,+HAA+H;KAChI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,qDAAqD;YAC9D,QAAQ,EAAE,mDAAmD;SAC9D;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,wGAAwG;YACjH,QAAQ,EAAE,2DAA2D;SACtE;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,+FAA+F;YACxG,QAAQ,EAAE,yEAAyE;SACpF;KACF;IACD,eAAe,EAAE,8HAA8H;IAC/I,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/pagemtimes.js

@@ -0,0 +1,123 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "pagemtimes",
+    "category": "math/linalg/ops",
+    "keywords": [
+        "pagemtimes",
+        "page-wise matrix multiplication",
+        "batched matrix multiply",
+        "linear algebra",
+        "gpuArray"
+    ],
+    "summary": "Multiply corresponding matrix pages in dense arrays.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "RunMat gathers GPU operands for host-complete scalar and transpose semantics, then uploads real and complex numeric results back to the active provider."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::linalg::ops::pagemtimes::tests",
+        "integration": "builtins::math::linalg::ops::pagemtimes::tests::gpu_input_roundtrips_to_gpu_result"
+    },
+    "description": "`pagemtimes(X,Y)` multiplies each corresponding two-dimensional matrix page of `X` and `Y`. Dimensions three and higher are page dimensions and use MATLAB-compatible singleton expansion.",
+    "behaviors": [
+        "Supports `Z = pagemtimes(X,Y)` and `Z = pagemtimes(X,transpX,Y,transpY)`.",
+        "`transpX` and `transpY` must both be present in the four-argument form and each must be `none`, `transpose`, or `ctranspose`.",
+        "The first two dimensions of each input form the matrix multiplied on each page. Page dimensions are dimensions three and higher and are expanded by position when one side has extent `1` or omits the trailing dimension.",
+        "If either operand is scalar, the result uses the first two dimensions of the nonscalar operand and performs page-wise scalar multiplication.",
+        "Dense `double`, `single`, and complex double arrays are supported. Integer, logical, sparse, cell, struct, object, and text inputs are rejected.",
+        "Complex `ctranspose` conjugates each page before multiplication; `transpose` only swaps the first two dimensions."
+    ],
+    "examples": [
+        {
+            "description": "Multiply matching pages",
+            "input": "X = reshape(1:8, [2 2 2]);\nY = reshape(10:17, [2 2 2]);\nZ = pagemtimes(X,Y)"
+        },
+        {
+            "description": "Broadcast a matrix across all pages",
+            "input": "X = eye(2);\nY = reshape(1:8, [2 2 2]);\nZ = pagemtimes(X,Y)"
+        },
+        {
+            "description": "Use transpose options",
+            "input": "X = rand(2,3,5);\nY = rand(2,4,5);\nZ = pagemtimes(X,'transpose',Y,'none');\nsize(Z)",
+            "output": "ans =\n     3     4     5"
+        },
+        {
+            "description": "Implicit expansion of page dimensions",
+            "input": "X = rand(10,8,1,3);\nY = rand(8,10,4,1);\nZ = pagemtimes(X,Y);\nsize(Z)",
+            "output": "ans =\n    10    10     4     3"
+        },
+        {
+            "description": "GPU inputs remain device-resident",
+            "input": "G = gpuArray(rand(3,3,8));\nH = pagemtimes(G,2);\nfirstPage = gather(H(:,:,1));"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How does `pagemtimes` differ from `mtimes`?",
+            "answer": "`mtimes` multiplies two matrices. `pagemtimes` treats every slice in dimensions three and higher as an independent matrix and multiplies corresponding pages with singleton expansion across page dimensions."
+        },
+        {
+            "question": "Can I specify only one transpose option?",
+            "answer": "No. MATLAB's four-argument form requires both `transpX` and `transpY`; use `none` for the operand that should not be transposed."
+        },
+        {
+            "question": "What happens when page dimensions do not match?",
+            "answer": "RunMat raises `RunMat:pagemtimes:PageDimensionMismatch` unless the differing page extent is `1` or omitted on one side."
+        }
+    ],
+    "links": [
+        {
+            "label": "mtimes",
+            "url": "./mtimes"
+        },
+        {
+            "label": "transpose",
+            "url": "./transpose"
+        },
+        {
+            "label": "ctranspose",
+            "url": "./ctranspose"
+        },
+        {
+            "label": "pagefun",
+            "url": "./pagefun"
+        },
+        {
+            "label": "gpuArray",
+            "url": "./gpuarray"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/linalg/ops/pagemtimes.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/linalg/ops/pagemtimes.rs"
+    },
+    "gpu_residency": "Yes for explicit `gpuArray` inputs. RunMat gathers when needed for host-complete semantics, then re-uploads real and complex numeric results to the active acceleration provider.",
+    "gpu_behavior": [
+        "`pagemtimes` exposes a custom GPU spec and keeps outputs resident when any input is a `gpuArray` and an acceleration provider is available.",
+        "Plain page-wise products may be accelerated by provider `pagefun` hooks in future backends; transpose and scalar forms currently use the host-complete fallback path."
+    ],
+    "key": "pagemtimes",
+    "slug": "pagemtimes",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "linalg",
+        "ops"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=pagemtimes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagemtimes.js","sourceRoot":"","sources":["../../../src/generated/builtins/pagemtimes.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE;QACV,YAAY;QACZ,iCAAiC;QACjC,yBAAyB;QACzB,gBAAgB;QAChB,UAAU;KACX;IACD,SAAS,EAAE,sDAAsD;IACjE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,0JAA0J;KACpK;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,gDAAgD;QACxD,aAAa,EAAE,oFAAoF;KACpG;IACD,aAAa,EAAE,4LAA4L;IAC3M,WAAW,EAAE;QACX,2EAA2E;QAC3E,+HAA+H;QAC/H,4NAA4N;QAC5N,8IAA8I;QAC9I,kJAAkJ;QAClJ,mHAAmH;KACpH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,+EAA+E;SACzF;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,8DAA8D;SACxE;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,sFAAsF;YAC/F,QAAQ,EAAE,2BAA2B;SACtC;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,yEAAyE;YAClF,QAAQ,EAAE,iCAAiC;SAC5C;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,iFAAiF;SAC3F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,+MAA+M;SAC1N;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,kIAAkI;SAC7I;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,yHAAyH;SACpI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,oEAAoE;QAC7E,KAAK,EAAE,iHAAiH;KACzH;IACD,eAAe,EAAE,mLAAmL;IACpM,cAAc,EAAE;QACd,6IAA6I;QAC7I,uKAAuK;KACxK;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;QACR,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/pagetranspose.js

@@ -0,0 +1,131 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "pagetranspose",
+    "category": "math/linalg/ops",
+    "keywords": [
+        "pagetranspose",
+        "page-wise transpose",
+        "non-conjugate transpose",
+        "permute",
+        "gpuArray"
+    ],
+    "summary": "Apply the nonconjugate transpose to every matrix page of an array.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64",
+            "i32",
+            "bool"
+        ],
+        "broadcasting": "none",
+        "notes": "Equivalent to `permute(X,[2 1 3:ndims(X)])`; providers may keep gpuArray results resident through the permute hook, otherwise RunMat gathers once, transposes on the host, and uploads the result."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::linalg::ops::pagetranspose::tests"
+    },
+    "description": "`Y = pagetranspose(X)` swaps the first two dimensions of `X` on every page without conjugating complex values. For N-D arrays, each output page `Y(:,:,i,j,...)` is the nonconjugate transpose of `X(:,:,i,j,...)`.",
+    "behaviors": [
+        "Equivalent to `permute(X,[2 1 3:ndims(X)])` for dense arrays.",
+        "Works for scalars, vectors, matrices, and N-D arrays; only the first two axes are swapped.",
+        "Complex values are not conjugated. Compose with `conj` when Hermitian page transpose semantics are needed.",
+        "Logical, character, string, and cell arrays preserve their element type while their first two dimensions are swapped.",
+        "Sparse matrices transpose through RunMat's sparse CSC transpose path.",
+        "Scalar structs are treated as 1-by-1 values and round-trip unchanged; true struct-array permutation will follow RunMat's struct-array representation when that lands.",
+        "gpuArray inputs remain device-resident when a provider is available; otherwise they fall back to host execution."
+    ],
+    "examples": [
+        {
+            "description": "Transpose each page of a 3-D array",
+            "input": "A = reshape(1:12, [2 3 2]);\nB = pagetranspose(A);\nsize(B)",
+            "output": "ans = [3 2 2]"
+        },
+        {
+            "description": "Preserve complex values without conjugation",
+            "input": "Z = reshape([1+2i 3-4i], [1 2 1]);\nY = pagetranspose(Z)",
+            "output": "Y =\n   1.0000 + 2.0000i\n   3.0000 - 4.0000i"
+        },
+        {
+            "description": "Use `pagetranspose` as the page-wise form of `transpose`",
+            "input": "A = rand(5, 3, 10);\nB = pagetranspose(A);\nsize(B)",
+            "output": "ans = [3 5 10]"
+        },
+        {
+            "description": "Transpose gpuArray pages while preserving residency",
+            "input": "G = gpuArray(rand(4, 2, 8));\nH = pagetranspose(G);\nisgpuarray(H)",
+            "output": "ans = logical 1"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How does `pagetranspose` differ from `transpose`?",
+            "answer": "For dense arrays they use the same first-two-dimension swap. `pagetranspose` names the page-wise intent explicitly for N-D arrays and mirrors MATLAB's page-wise API."
+        },
+        {
+            "question": "Does `pagetranspose` conjugate complex numbers?",
+            "answer": "No. It is the page-wise nonconjugate transpose."
+        },
+        {
+            "question": "What happens to dimensions three and higher?",
+            "answer": "They stay in the same order and size. Only dimensions one and two are swapped."
+        },
+        {
+            "question": "Is the result a view?",
+            "answer": "No. RunMat materializes a new value, although GPU providers may optimize the data movement internally."
+        }
+    ],
+    "links": [
+        {
+            "label": "transpose",
+            "url": "./transpose"
+        },
+        {
+            "label": "ctranspose",
+            "url": "./ctranspose"
+        },
+        {
+            "label": "pagemtimes",
+            "url": "./pagemtimes"
+        },
+        {
+            "label": "permute",
+            "url": "./permute"
+        },
+        {
+            "label": "gpuArray",
+            "url": "./gpuarray"
+        },
+        {
+            "label": "gather",
+            "url": "./gather"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/linalg/ops/pagetranspose.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/linalg/ops/pagetranspose.rs"
+    },
+    "gpu_residency": "Yes for explicit `gpuArray` inputs when an acceleration provider is available.",
+    "gpu_behavior": [
+        "`pagetranspose` uses the same provider `permute` hook as `permute(X,[2 1 3:ndims(X)])`.",
+        "If the provider lacks a native hook, RunMat gathers, performs the page-wise transpose on the host, and uploads the result back to the provider."
+    ],
+    "key": "pagetranspose",
+    "slug": "pagetranspose",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "linalg",
+        "ops"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=pagetranspose.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagetranspose.js","sourceRoot":"","sources":["../../../src/generated/builtins/pagetranspose.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,eAAe;IACxB,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE;QACV,eAAe;QACf,qBAAqB;QACrB,yBAAyB;QACzB,SAAS;QACT,UAAU;KACX;IACD,SAAS,EAAE,oEAAoE;IAC/E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;YACL,KAAK;YACL,MAAM;SACP;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,oMAAoM;KAC9M;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,mDAAmD;KAC5D;IACD,aAAa,EAAE,qNAAqN;IACpO,WAAW,EAAE;QACX,+DAA+D;QAC/D,4FAA4F;QAC5F,4GAA4G;QAC5G,uHAAuH;QACvH,uEAAuE;QACvE,uKAAuK;QACvK,kHAAkH;KACnH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,6DAA6D;YACtE,QAAQ,EAAE,eAAe;SAC1B;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,0DAA0D;YACnE,QAAQ,EAAE,+CAA+C;SAC1D;QACD;YACE,aAAa,EAAE,0DAA0D;YACzE,OAAO,EAAE,qDAAqD;YAC9D,QAAQ,EAAE,gBAAgB;SAC3B;QACD;YACE,aAAa,EAAE,qDAAqD;YACpE,OAAO,EAAE,oEAAoE;YAC7E,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,uKAAuK;SAClL;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,iDAAiD;SAC5D;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,gFAAgF;SAC3F;QACD;YACE,UAAU,EAAE,uBAAuB;YACnC,QAAQ,EAAE,wGAAwG;SACnH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,uEAAuE;QAChF,KAAK,EAAE,oHAAoH;KAC5H;IACD,eAAe,EAAE,gFAAgF;IACjG,cAAc,EAAE;QACd,yFAAyF;QACzF,iJAAiJ;KAClJ;IACD,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;QACR,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

@@ -0,0 +1,89 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "pan",
+    "category": "plotting",
+    "keywords": [
+        "pan",
+        "axes pan",
+        "figure pan",
+        "interactive plotting"
+    ],
+    "summary": "Control interactive axes panning for figures and axes.",
+    "status": "done",
+    "version_added": "0.5.3",
+    "tests": {
+        "unit": "builtins::plotting::pan::tests"
+    },
+    "description": "`pan` toggles or configures MATLAB-compatible figure panning state. It supports figure and axes targets, returns a live pan mode object, and integrates with `get` and `set` for common pan object properties.",
+    "syntax": [
+        "pan",
+        "pan(option)",
+        "pan(fig, option)",
+        "pan(ax, option)",
+        "p = pan",
+        "p = pan(fig)"
+    ],
+    "arguments": [
+        {
+            "name": "option",
+            "type": "'on' | 'off' | 'toggle' | 'xon' | 'yon'",
+            "description": "Pan mode command. `xon` and `yon` enable panning constrained to the horizontal or vertical axis."
+        },
+        {
+            "name": "fig",
+            "type": "figure handle",
+            "description": "Target figure handle."
+        },
+        {
+            "name": "ax",
+            "type": "axes handle",
+            "description": "Target axes handle."
+        }
+    ],
+    "examples": [
+        {
+            "description": "Enable horizontal panning",
+            "input": "plot(1:10);\npan xon;",
+            "output": "% Pan mode is enabled horizontally"
+        },
+        {
+            "description": "Use the pan object with get and set",
+            "input": "p = pan;\nset(p, 'Enable', 'on', 'Motion', 'vertical');\nget(p, 'Motion')",
+            "output": "ans = 'vertical'"
+        }
+    ],
+    "notes": [
+        "Statement-form `pan()` toggles pan mode. Output-form `p = pan()` returns a pan handle object.",
+        "The pan object supports `Enable`, `Motion`, `UIContextMenu`, `ButtonDownFilter`, `ActionPreCallback`, `ActionPostCallback`, and `FigureHandle` properties."
+    ],
+    "gpu_residency": "`pan` mutates plotting interaction metadata only. It does not gather or copy GPU-resident plot data.",
+    "related": [
+        {
+            "label": "zoom",
+            "url": "./zoom"
+        },
+        {
+            "label": "get",
+            "url": "./get"
+        },
+        {
+            "label": "set",
+            "url": "./set"
+        }
+    ],
+    "implemented_in": [
+        {
+            "label": "crates/runmat-runtime/src/builtins/plotting/ops/pan.rs",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/pan.rs"
+        }
+    ],
+    "key": "pan",
+    "slug": "pan",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=pan.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pan.js","sourceRoot":"","sources":["../../../src/generated/builtins/pan.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,KAAK;QACL,UAAU;QACV,YAAY;QACZ,sBAAsB;KACvB;IACD,SAAS,EAAE,wDAAwD;IACnE,QAAQ,EAAE,MAAM;IAChB,eAAe,EAAE,OAAO;IACxB,OAAO,EAAE;QACP,MAAM,EAAE,gCAAgC;KACzC;IACD,aAAa,EAAE,gNAAgN;IAC/N,QAAQ,EAAE;QACR,KAAK;QACL,aAAa;QACb,kBAAkB;QAClB,iBAAiB;QACjB,SAAS;QACT,cAAc;KACf;IACD,WAAW,EAAE;QACX;YACE,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,yCAAyC;YACjD,aAAa,EAAE,kGAAkG;SAClH;QACD;YACE,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,eAAe;YACvB,aAAa,EAAE,uBAAuB;SACvC;QACD;YACE,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,aAAa;YACrB,aAAa,EAAE,qBAAqB;SACrC;KACF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,uBAAuB;YAChC,QAAQ,EAAE,oCAAoC;SAC/C;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,2EAA2E;YACpF,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,OAAO,EAAE;QACP,+FAA+F;QAC/F,4JAA4J;KAC7J;IACD,eAAe,EAAE,sGAAsG;IACvH,SAAS,EAAE;QACT;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,gBAAgB,EAAE;QAChB;YACE,OAAO,EAAE,wDAAwD;YACjE,KAAK,EAAE,uGAAuG;SAC/G;KACF;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/parquetDatastore.js

@@ -0,0 +1,61 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "parquetDatastore",
+    "category": "io/tabular",
+    "keywords": [
+        "parquetDatastore",
+        "datastore",
+        "parquet",
+        "table"
+    ],
+    "summary": "Create a parquet datastore descriptor object.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Datastore descriptors are host metadata."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::table::tests"
+    },
+    "description": "`parquetDatastore(files)` creates a descriptor object with a `Files` property for parquet table workflows.",
+    "behaviors": [
+        "The constructor preserves file specifications for code that passes datastore descriptors around.",
+        "Parquet decoding and iterator-style operations such as `read`, `hasdata`, and `reset` require the generic datastore dispatch layer and are not provided by this constructor builtin."
+    ],
+    "examples": [
+        {
+            "description": "Create parquet datastore descriptor",
+            "input": "ds = parquetDatastore('data.parquet')",
+            "output": "ds = parquetDatastore object"
+        }
+    ],
+    "links": [
+        {
+            "label": "arrayDatastore",
+            "url": "./arrayDatastore"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/table/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/table/mod.rs"
+    },
+    "key": "parquetdatastore",
+    "slug": "parquetdatastore",
+    "aliases": [],
+    "categoryPath": [
+        "io",
+        "tabular"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=parquetDatastore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parquetDatastore.js","sourceRoot":"","sources":["../../../src/generated/builtins/parquetDatastore.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,kBAAkB;IAC3B,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,kBAAkB;QAClB,WAAW;QACX,SAAS;QACT,OAAO;KACR;IACD,SAAS,EAAE,+CAA+C;IAC1D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0CAA0C;KACpD;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,wBAAwB;KACjC;IACD,aAAa,EAAE,4GAA4G;IAC3H,WAAW,EAAE;QACX,kGAAkG;QAClG,sLAAsL;KACvL;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,8BAA8B;SACzC;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,kBAAkB;SAC1B;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mDAAmD;QAC5D,KAAK,EAAE,gGAAgG;KACxG;IACD,KAAK,EAAE,kBAAkB;IACzB,MAAM,EAAE,kBAAkB;IAC1B,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/parquetinfo.js

@@ -0,0 +1,74 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "parquetinfo",
+    "category": "io/tabular",
+    "keywords": [
+        "parquetinfo",
+        "parquet",
+        "schema",
+        "row groups",
+        "metadata"
+    ],
+    "summary": "Inspect Parquet file schema and row-group metadata.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Metadata inspection is host file I/O and does not create GPU-resident arrays."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::table::tests::parquetinfo_reports_schema_and_row_groups",
+        "integration": null
+    },
+    "description": "`parquetinfo(filename)` reads Parquet file metadata and returns a scalar struct containing filename, file size, row count, row-group count, variable count, variable names, variable physical types, writer version, creator string, row-group metadata, compression labels, and encoding labels.",
+    "behaviors": [
+        "The file footer and schema are parsed with the same Arrow-backed Parquet reader used by `parquetread`.",
+        "Row groups are reported as a struct with `RowGroup1`, `RowGroup2`, and so on, each containing row count, total byte size, and column count.",
+        "Compression and encoding labels are reported from the first row group when row groups are present."
+    ],
+    "examples": [
+        {
+            "description": "Inspect Parquet metadata",
+            "input": "info = parquetinfo(\"measurements.parquet\")",
+            "output": "info = struct"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does parquetinfo decode the whole file?",
+            "answer": "No. It reads the Parquet metadata footer and schema, not the full data payload."
+        }
+    ],
+    "links": [
+        {
+            "label": "parquetread",
+            "url": "./parquetread"
+        },
+        {
+            "label": "parquetDatastore",
+            "url": "./parquetDatastore"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/table/import/parquet.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/table/import/parquet.rs"
+    },
+    "key": "parquetinfo",
+    "slug": "parquetinfo",
+    "aliases": [],
+    "categoryPath": [
+        "io",
+        "tabular"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=parquetinfo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parquetinfo.js","sourceRoot":"","sources":["../../../src/generated/builtins/parquetinfo.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,aAAa;QACb,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,UAAU;KACX;IACD,SAAS,EAAE,qDAAqD;IAChE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,+EAA+E;KACzF;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,mEAAmE;QAC3E,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,mSAAmS;IAClT,WAAW,EAAE;QACX,wGAAwG;QACxG,6IAA6I;QAC7I,oGAAoG;KACrG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,eAAe;SAC1B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,iFAAiF;SAC5F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,oBAAoB;SAC5B;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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