runmat 0.6.1 → 0.6.2-dev.1

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

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

package/dist/generated/builtins/text.js

@@ -0,0 +1,90 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "text",
+    "category": "plotting",
+    "keywords": [
+        "text",
+        "annotation",
+        "label",
+        "plotting"
+    ],
+    "summary": "Add text at a position in a 2-D or 3-D plot.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Text is rendered on the host. Automatically resident coordinates are gathered through their owning provider. Explicit gpuArray coordinates are available only in RunMat mode."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": "plot-core",
+    "tested": {
+        "unit": "builtins::plotting::text::tests",
+        "integration": null
+    },
+    "description": "`text(x,y,txt)` adds an annotation at a 2-D position. Include `z` for a 3-D position, or provide an axes handle first to select the target axes.",
+    "behaviors": [
+        "Coordinates can use single, double, or any of the eight integer classes.",
+        "The `Position` property retains the coordinate class, shape, and exact values. Rendering uses a separate floating-point geometry cache.",
+        "A two-element `Position` value is stored with a third coordinate of zero in the same numeric class.",
+        "The returned graphics handle supports `get` and `set` for `String`, `Position`, `FontWeight`, `FontAngle`, `Interpreter`, `Color`, `FontSize`, and `Visible`.",
+        "Typed-integer numeric axes aliases and explicit gpuArray coordinates are RunMat-mode extensions."
+    ],
+    "examples": [
+        {
+            "description": "Label a point on a curve",
+            "input": "plot(1:5, [2 4 3 5 4]);\nh = text(4, 5, \"peak\");"
+        },
+        {
+            "description": "Add a 3-D annotation",
+            "input": "plot3(1:3, 2:4, 5:7);\nh = text(2, 3, 6, \"sample\");"
+        },
+        {
+            "description": "Use integer coordinates",
+            "input": "h = text(int64(12), int64(-3), \"checkpoint\");\nposition = get(h, \"Position\")",
+            "output": "position = 1×3 int64\n    12    -3     0"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Are integer positions converted to double?",
+            "answer": "No. The graphics property keeps native integer storage and exact values. Only the derived coordinates sent to the renderer are converted."
+        },
+        {
+            "question": "Can `text` label several points in one call?",
+            "answer": "Not yet. Each call currently accepts one scalar 2-D or 3-D position; vector coordinates and per-point label arrays remain unsupported."
+        },
+        {
+            "question": "Can I pass resident coordinates?",
+            "answer": "Automatically resident coordinates are gathered transparently through their owning provider. Explicit gpuArray coordinates require RunMat mode because the current public compatibility target does not document an interactive GPU form for `text`."
+        }
+    ],
+    "links": [
+        {
+            "label": "plot",
+            "url": "./plot"
+        },
+        {
+            "label": "title",
+            "url": "./title"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/text.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/text.rs"
+    },
+    "key": "text",
+    "slug": "text",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=text.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/generated/builtins/text.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,YAAY;QACZ,OAAO;QACP,UAAU;KACX;IACD,SAAS,EAAE,8CAA8C;IACzD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,+KAA+K;KACzL;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,WAAW;IAC/B,QAAQ,EAAE;QACR,MAAM,EAAE,iCAAiC;QACzC,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,kJAAkJ;IACjK,WAAW,EAAE;QACX,0EAA0E;QAC1E,yIAAyI;QACzI,qGAAqG;QACrG,+JAA+J;QAC/J,kGAAkG;KACnG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,oDAAoD;SAC9D;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,uDAAuD;SACjE;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,kFAAkF;YAC3F,QAAQ,EAAE,0CAA0C;SACrD;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,2IAA2I;SACtJ;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,wIAAwI;SACnJ;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,sPAAsP;SACjQ;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/textscan.js

@@ -45,12 +45,13 @@ const builtinDoc = {
     "behaviors": [
         "Accepts string, string-array scalar, row character-vector, numeric file identifier, or scalar numeric tensor file identifier as the first argument.",
         "Supports optional repeat count `N` before name-value options.",
-        "Supports numeric conversions `%f`, `%e`, `%g`, `%d`, `%i`, and `%u`; text conversions `%s`, `%q`, `%c`, and character-set conversions such as `%[ABC]` and `%[^,]`.",
+        "Supports floating conversions including `%f32` and `%f64`, decimal integer conversions `%d`, `%i`, and `%u`, hexadecimal `%x`, and binary `%b`. Documented size and signedness suffixes select native `int8` through `int64` or `uint8` through `uint64`; unsuffixed decimal signed/unsigned conversions return `int32`/`uint32`, and unsuffixed hexadecimal/binary conversions return `uint64`.",
         "Supports skipped conversions with `%*` and field widths such as `%5f` or `%10s`.",
-        "Text columns return cell columns of strings. Numeric columns return column tensors. With `'CollectOutput', true`, adjacent numeric columns are grouped into one numeric matrix.",
+        "Text columns return cell columns of strings. Numeric columns retain their selected native class, including exact 64-bit integers and physical single precision. With `'CollectOutput', true`, only adjacent numeric columns of the same class are grouped into one matrix.",
         "Recognizes `Delimiter`, `MultipleDelimsAsOne`, `HeaderLines`, `TreatAsEmpty`, `CommentStyle`, `CollectOutput`, `ReturnOnError`, and `Whitespace` options.",
         "Line comments and block comments are ignored while scanning input. Blank records are skipped after header/comment processing.",
-        "`ReturnOnError` defaults to true, returning data parsed before the first incompatible token. Set it to false to raise a parse error."
+        "`ReturnOnError` defaults to true, returning data parsed before the first incompatible token. Set it to false to raise a parse error.",
+        "Typed-integer file identifiers, repeat counts, and numeric controls are RunMat-only extensions. MATLAB compatibility mode rejects them before scanning; documented integer conversion specifiers remain enabled in both modes."
     ],
     "examples": [
         {
@@ -73,7 +74,7 @@ const builtinDoc = {
         },
         {
             "question": "How are text outputs represented?",
-            "answer": "Text conversions return cell columns containing string values. Numeric conversions return dense double tensors."
+            "answer": "Text conversions return cell columns containing string values. Numeric conversions return dense tensors in the class selected by the format specifier; integer columns are not routed through double."
         },
         {
             "question": "When should I use `readmatrix` instead?",

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

@@ -1 +1 @@
-{"version":3,"file":"textscan.js","sourceRoot":"","sources":["../../../src/generated/builtins/textscan.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,WAAW;IACvB,UAAU,EAAE;QACV,UAAU;QACV,gBAAgB;QAChB,kBAAkB;QAClB,WAAW;QACX,QAAQ;QACR,KAAK;QACL,YAAY;KACb;IACD,SAAS,EAAE,wDAAwD;IACnE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0FAA0F;KACpG;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,+BAA+B;QACvC,aAAa,EAAE;YACb,uEAAuE;YACvE,0FAA0F;YAC1F,iFAAiF;YACjF,qFAAqF;YACrF,+EAA+E;YAC/E,wEAAwE;YACxE,oFAAoF;YACpF,6FAA6F;YAC7F,2FAA2F;SAC5F;KACF;IACD,aAAa,EAAE,mJAAmJ;IAClK,WAAW,EAAE;QACX,qJAAqJ;QACrJ,+DAA+D;QAC/D,qKAAqK;QACrK,kFAAkF;QAClF,iLAAiL;QACjL,2JAA2J;QAC3J,+HAA+H;QAC/H,sIAAsI;KACvI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,iFAAiF;SAC3F;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,kIAAkI;SAC5I;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,iGAAiG;SAC3G;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,qHAAqH;SAChI;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,4KAA4K;SACvL;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qDAAqD;QAC9D,KAAK,EAAE,kGAAkG;KAC1G;IACD,eAAe,EAAE,4HAA4H;IAC7I,cAAc,EAAE;QACd,uEAAuE;KACxE;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"textscan.js","sourceRoot":"","sources":["../../../src/generated/builtins/textscan.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,WAAW;IACvB,UAAU,EAAE;QACV,UAAU;QACV,gBAAgB;QAChB,kBAAkB;QAClB,WAAW;QACX,QAAQ;QACR,KAAK;QACL,YAAY;KACb;IACD,SAAS,EAAE,wDAAwD;IACnE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0FAA0F;KACpG;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,+BAA+B;QACvC,aAAa,EAAE;YACb,uEAAuE;YACvE,0FAA0F;YAC1F,iFAAiF;YACjF,qFAAqF;YACrF,+EAA+E;YAC/E,wEAAwE;YACxE,oFAAoF;YACpF,6FAA6F;YAC7F,2FAA2F;SAC5F;KACF;IACD,aAAa,EAAE,mJAAmJ;IAClK,WAAW,EAAE;QACX,qJAAqJ;QACrJ,+DAA+D;QAC/D,kYAAkY;QAClY,kFAAkF;QAClF,4QAA4Q;QAC5Q,2JAA2J;QAC3J,+HAA+H;QAC/H,sIAAsI;QACtI,gOAAgO;KACjO;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,iFAAiF;SAC3F;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,kIAAkI;SAC5I;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,iGAAiG;SAC3G;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,qHAAqH;SAChI;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,uMAAuM;SAClN;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,4KAA4K;SACvL;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qDAAqD;QAC9D,KAAK,EAAE,kGAAkG;KAC1G;IACD,eAAe,EAAE,4HAA4H;IAC7I,cAAc,EAAE;QACd,uEAAuE;KACxE;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/textscatter.js

@@ -17,7 +17,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "`textscatter` is a chart/annotation rendering sink. Coordinates are materialized on the host so text annotations can be created; marker rendering reuses the existing scatter plot path."
+        "notes": "`textscatter` is a host chart and annotation sink. Automatically resident inputs are gathered through their exact owning provider. Explicit gpuArray input is a RunMat-mode extension."
     },
     "fusion": {
         "elementwise": false,
@@ -30,10 +30,11 @@ const builtinDoc = {
         "unit": "builtins::plotting::textscatter::tests",
         "vm": "crates/runmat-vm/tests/plotting.rs"
     },
-    "description": "`textscatter(x,y,str)` creates a text scatter chart with labels from `str` at matching x/y coordinates. `textscatter(xy,str)` accepts an N-by-2 coordinate matrix. The returned handle is a `textscatter` chart object with MATLAB-style data and display properties.",
+    "description": "`textscatter(x,y,str)` creates a text scatter chart with labels from `str` at matching x/y coordinates. `textscatter(xy,str)` accepts an N-by-2 coordinate matrix. The returned handle provides chart data and display properties.",
     "behaviors": [
         "`x`, `y`, and `str` must have equal element counts.",
         "`xy` must be an N-by-2 matrix whose first and second columns provide x and y coordinates.",
+        "Coordinates can use single, double, or any of the eight integer classes. `XData` and `YData` retain their native class, shape, and exact values.",
         "`str` can be a string scalar, string array, character row, character matrix, or cell array of text scalars.",
         "The axes-target form `textscatter(ax,...)` renders into the supplied axes handle.",
         "`TextDensityPercentage` controls how many labels are visible; `0` hides all text labels and `100` shows all labels and suppresses marker creation.",
@@ -41,7 +42,8 @@ const builtinDoc = {
         "`MarkerColor` accepts `auto`, `none`, or an RGB color. `ColorData` accepts an RGB triplet or N-by-3 RGB matrix for text colors.",
         "`get` supports `Type`, `Parent`, `Children`, `TextData`, `XData`, `YData`, `ZData`, `TextDensityPercentage`, `MaxTextLength`, `MarkerColor`, `MarkerSize`, `ColorData`, `Colors`, `Visible`, `DisplayName`, and `Tag`; 2-D charts report empty `ZData`.",
         "`set` supports `TextData`, `XData`, `YData`, `TextDensityPercentage`, `MaxTextLength`, `MarkerColor`, `MarkerSize`, `ColorData`, `Colors`, `Visible`, `Color`, `FontSize`, `FontWeight`, `FontAngle`, and `Interpreter`. `ZData` mutation is reserved for `textscatter3` charts.",
-        "Categorical `ColorData`, datasource properties, callbacks, app data, and interactive data-tip template objects are not implemented yet and raise explicit unsupported-property errors."
+        "Categorical `ColorData`, datasource properties, callbacks, app data, and interactive data-tip template objects are not implemented yet and raise explicit unsupported-property errors.",
+        "Typed-integer numeric axes aliases and explicit gpuArray inputs are RunMat-mode extensions."
     ],
     "examples": [
         {
@@ -68,7 +70,11 @@ const builtinDoc = {
         },
         {
             "question": "Can textscatter preserve gpuArray residency?",
-            "answer": "Not currently. Text annotations require host coordinate and label materialization. Marker rendering reuses the existing scatter plot path once the chart has been constructed."
+            "answer": "The chart and its annotations are host graphics objects. Automatically resident inputs are gathered transparently through their owning provider. Explicit gpuArray inputs require RunMat mode."
+        },
+        {
+            "question": "Does `get(ts,'XData')` preserve integer values?",
+            "answer": "Yes. Coordinate properties use authoritative native storage, including `int64` and `uint64` values outside the exact double range. Renderer geometry is a separate derived cache."
         }
     ],
     "links": [

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

@@ -1 +1 @@
-{"version":3,"file":"textscatter.js","sourceRoot":"","sources":["../../../src/generated/builtins/textscatter.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,aAAa;QACb,cAAc;QACd,gBAAgB;QAChB,qBAAqB;QACrB,eAAe;QACf,oBAAoB;KACrB;IACD,SAAS,EAAE,uEAAuE;IAClF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0LAA0L;KACpM;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,wCAAwC;QAChD,IAAI,EAAE,oCAAoC;KAC3C;IACD,aAAa,EAAE,uQAAuQ;IACtR,WAAW,EAAE;QACX,qDAAqD;QACrD,2FAA2F;QAC3F,6GAA6G;QAC7G,mFAAmF;QACnF,oJAAoJ;QACpJ,+EAA+E;QAC/E,iIAAiI;QACjI,yPAAyP;QACzP,kRAAkR;QAClR,wLAAwL;KACzL;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,kGAAkG;SAC5G;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,sEAAsE;SAChF;QACD;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,oLAAoL;SAC9L;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,uNAAuN;SAClO;QACD;YACE,UAAU,EAAE,0BAA0B;YACtC,QAAQ,EAAE,qMAAqM;SAChN;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,gLAAgL;SAC3L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;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,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"textscatter.js","sourceRoot":"","sources":["../../../src/generated/builtins/textscatter.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,aAAa;QACb,cAAc;QACd,gBAAgB;QAChB,qBAAqB;QACrB,eAAe;QACf,oBAAoB;KACrB;IACD,SAAS,EAAE,uEAAuE;IAClF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,wLAAwL;KAClM;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,wCAAwC;QAChD,IAAI,EAAE,oCAAoC;KAC3C;IACD,aAAa,EAAE,oOAAoO;IACnP,WAAW,EAAE;QACX,qDAAqD;QACrD,2FAA2F;QAC3F,kJAAkJ;QAClJ,6GAA6G;QAC7G,mFAAmF;QACnF,oJAAoJ;QACpJ,+EAA+E;QAC/E,iIAAiI;QACjI,yPAAyP;QACzP,kRAAkR;QAClR,wLAAwL;QACxL,6FAA6F;KAC9F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,kGAAkG;SAC5G;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,sEAAsE;SAChF;QACD;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,oLAAoL;SAC9L;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,uNAAuN;SAClO;QACD;YACE,UAAU,EAAE,0BAA0B;YACtC,QAAQ,EAAE,qMAAqM;SAChN;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,gMAAgM;SAC3M;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,mLAAmL;SAC9L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;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,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/textscatter3.js

@@ -17,7 +17,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "`textscatter3` is a chart/annotation rendering sink. Coordinates are materialized on the host so text annotations can be created; marker rendering reuses the existing scatter3 plot path."
+        "notes": "`textscatter3` is a host chart and annotation sink. Automatically resident inputs are gathered through their exact owning provider. Explicit gpuArray input is a RunMat-mode extension."
     },
     "fusion": {
         "elementwise": false,
@@ -34,13 +34,15 @@ const builtinDoc = {
     "behaviors": [
         "`x`, `y`, `z`, and `str` must have equal element counts.",
         "`xyz` must be an N-by-3 matrix whose first, second, and third columns provide x, y, and z coordinates.",
+        "Coordinates can use single, double, or any of the eight integer classes. `XData`, `YData`, and `ZData` retain their native class, shape, and exact values.",
         "`str` can be a string scalar, string array, character row, character matrix, or cell array of text scalars.",
         "The axes-target form `textscatter3(ax,...)` renders into the supplied axes handle.",
         "`ZData` is populated from the z coordinates and can be queried with `get`.",
         "`TextDensityPercentage`, `MaxTextLength`, `MarkerColor`, `MarkerSize`, `ColorData`, `Colors`, and `Visible` follow the same semantics as `textscatter`.",
         "`get` supports `Type`, `Parent`, `Children`, `TextData`, `XData`, `YData`, `ZData`, `TextDensityPercentage`, `MaxTextLength`, `MarkerColor`, `MarkerSize`, `ColorData`, `Colors`, `Visible`, `DisplayName`, and `Tag`.",
         "`set` supports `TextData`, `XData`, `YData`, `ZData`, `TextDensityPercentage`, `MaxTextLength`, `MarkerColor`, `MarkerSize`, `ColorData`, `Colors`, `Visible`, `Color`, `FontSize`, `FontWeight`, `FontAngle`, and `Interpreter`.",
-        "Categorical `ColorData`, datasource properties, callbacks, app data, and interactive data-tip template objects are not implemented yet and raise explicit unsupported-property errors."
+        "Categorical `ColorData`, datasource properties, callbacks, app data, and interactive data-tip template objects are not implemented yet and raise explicit unsupported-property errors.",
+        "Typed-integer numeric axes aliases and explicit gpuArray inputs are RunMat-mode extensions."
     ],
     "examples": [
         {
@@ -68,7 +70,11 @@ const builtinDoc = {
         },
         {
             "question": "Can textscatter3 preserve gpuArray residency?",
-            "answer": "Not currently. Text annotations require host coordinate and label materialization. Marker rendering reuses the existing scatter3 plot path once the chart has been constructed."
+            "answer": "The chart and its annotations are host graphics objects. Automatically resident inputs are gathered transparently through their owning provider. Explicit gpuArray inputs require RunMat mode."
+        },
+        {
+            "question": "Does `get(ts,'ZData')` preserve integer values?",
+            "answer": "Yes. All three coordinate properties use authoritative native storage, including `int64` and `uint64` values outside the exact double range. Renderer geometry is a separate derived cache."
         }
     ],
     "links": [

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

@@ -1 +1 @@
-{"version":3,"file":"textscatter3.js","sourceRoot":"","sources":["../../../src/generated/builtins/textscatter3.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,cAAc;QACd,kBAAkB;QAClB,gBAAgB;QAChB,qBAAqB;QACrB,eAAe;QACf,qBAAqB;KACtB;IACD,SAAS,EAAE,yEAAyE;IACpF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,4LAA4L;KACtM;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,wCAAwC;QAChD,IAAI,EAAE,oCAAoC;KAC3C;IACD,aAAa,EAAE,qQAAqQ;IACpR,WAAW,EAAE;QACX,0DAA0D;QAC1D,wGAAwG;QACxG,6GAA6G;QAC7G,oFAAoF;QACpF,4EAA4E;QAC5E,yJAAyJ;QACzJ,wNAAwN;QACxN,mOAAmO;QACnO,wLAAwL;KACzL;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,oHAAoH;SAC9H;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,+EAA+E;SACzF;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,0EAA0E;YACnF,QAAQ,EAAE,qBAAqB;SAChC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oEAAoE;YAChF,QAAQ,EAAE,+JAA+J;SAC1K;QACD;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,kIAAkI;SAC7I;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,iLAAiL;SAC5L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;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,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"textscatter3.js","sourceRoot":"","sources":["../../../src/generated/builtins/textscatter3.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,cAAc;QACd,kBAAkB;QAClB,gBAAgB;QAChB,qBAAqB;QACrB,eAAe;QACf,qBAAqB;KACtB;IACD,SAAS,EAAE,yEAAyE;IACpF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yLAAyL;KACnM;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,wCAAwC;QAChD,IAAI,EAAE,oCAAoC;KAC3C;IACD,aAAa,EAAE,qQAAqQ;IACpR,WAAW,EAAE;QACX,0DAA0D;QAC1D,wGAAwG;QACxG,4JAA4J;QAC5J,6GAA6G;QAC7G,oFAAoF;QACpF,4EAA4E;QAC5E,yJAAyJ;QACzJ,wNAAwN;QACxN,mOAAmO;QACnO,wLAAwL;QACxL,6FAA6F;KAC9F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,oHAAoH;SAC9H;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,+EAA+E;SACzF;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,0EAA0E;YACnF,QAAQ,EAAE,qBAAqB;SAChC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oEAAoE;YAChF,QAAQ,EAAE,+JAA+J;SAC1K;QACD;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,kIAAkI;SAC7I;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,gMAAgM;SAC3M;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,6LAA6L;SACxM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;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,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/tf.js

@@ -17,7 +17,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "`tf` constructs host-side metadata. If coefficient inputs are gpuArray values, RunMat gathers them before creating the object."
+        "notes": "`tf` constructs host-side model metadata. Automatically resident inputs are gathered through their owning provider; explicit gpuArray input is a RunMat-mode extension."
     },
     "fusion": {
         "elementwise": false,
@@ -31,21 +31,21 @@ const builtinDoc = {
         "unit": "builtins::control::tf::tests",
         "integration": "crates/runmat-vm/tests/control.rs"
     },
-    "description": "`tf('s')` creates a continuous-time transfer-function variable, and `tf(num, den)` creates scalar-input scalar-output transfer-function objects from numeric coefficient vectors. Coefficients follow MATLAB-compatible highest-order-to-constant polynomial ordering.",
+    "description": "`tf('s')` creates a continuous-time transfer-function variable, and `tf(num, den)` creates scalar-input scalar-output transfer-function objects from numeric coefficient vectors. Coefficients are ordered from the highest power to the constant term.",
     "behaviors": [
-        "`tf('s')` and `tf('p')` create continuous-time transfer-function variables with numerator `[1 0]`, denominator `[1]`, and `Ts = 0`.",
-        "`tf('z', Ts)`, `tf('q', Ts)`, `tf('z^-1', Ts)`, and `tf('q^-1', Ts)` create discrete-time variables with a positive sample time.",
+        "`tf('s')` creates a continuous-time transfer-function variable with numerator `[1 0]`, denominator `[1]`, and `Ts = 0`.",
+        "`tf('z',Ts)` creates a discrete-time variable with a positive sample time or `Ts = -1` for an unspecified sample time.",
         "Accepts numeric scalar, row-vector, or column-vector numerator coefficients.",
         "Accepts numeric scalar, row-vector, or column-vector denominator coefficients.",
         "Normalizes stored numerator and denominator coefficients to row vectors on the returned `tf` object.",
         "Returns a lightweight object whose class name is `tf`.",
         "Stores `Numerator`, `Denominator`, `Variable`, `Ts`, `InputDelay`, and `OutputDelay` properties on the object.",
         "Uses continuous-time defaults: `Variable` is `'s'` and `Ts` is `0`.",
-        "`tf(num, den, Ts)` stores a finite non-negative sample time and defaults `Variable` to `'z'`.",
-        "`tf(num, den, 'Variable', variable)` accepts `variable` values `'s'`, `'p'`, `'z'`, `'q'`, `'z^-1'`, and `'q^-1'`.",
-        "`tf(num, den, 'Ts', Ts)` or `tf(num, den, 'SampleTime', Ts)` stores a finite non-negative sample time.",
+        "`tf(num,den,Ts)` stores `0` for continuous time, a positive discrete sample time, or `-1` for unspecified discrete time. Nonzero sample times default `Variable` to `'z'`.",
+        "RunMat mode additionally accepts the variable aliases `'p'`, `'q'`, `'z^-1'`, and `'q^-1'`, and allows `tf('z')` to default to `Ts = 1`.",
         "Complex coefficients are accepted and stored as complex row vectors.",
-        "Logical and integer coefficients are promoted to double precision.",
+        "In RunMat mode, logical and typed-integer coefficients enter a checked double-precision model boundary. Typed-integer sample time is gated separately.",
+        "Automatically resident coefficients are gathered through their owning provider. Explicit gpuArray input requires RunMat mode, and the returned model remains host-side.",
         "`tf` objects overload `+`, `-`, unary `+`, unary `-`, `*`, `.*`, `/`, `./`, `\\`, `.\\`, `^`, and `.^` for SISO transfer-function algebra with scalar gains.",
         "Transfer-function powers require integer scalar exponents.",
         "Arithmetic requires compatible sample times and does not support nonzero input or output delays."
@@ -85,11 +85,11 @@ const builtinDoc = {
     "faqs": [
         {
             "question": "Does `tf` evaluate the transfer function at frequency points?",
-            "answer": "No. This implementation only constructs the transfer-function object. Frequency-response helpers such as `bode`, `freqresp`, and `evalfr` are separate Control System Toolbox functions."
+            "answer": "No. `tf` constructs the transfer-function object. Frequency-response helpers such as `bode`, `freqresp`, and `evalfr` are separate functions."
         },
         {
             "question": "Does `tf` support MIMO transfer functions?",
-            "answer": "Not yet. This implementation supports scalar-input scalar-output systems created from numeric coefficient vectors."
+            "answer": "Not yet. `tf` currently supports scalar-input scalar-output systems created from numeric coefficient vectors."
         },
         {
             "question": "Can I build models with `s = tf('s')`?",
@@ -106,6 +106,14 @@ const builtinDoc = {
         {
             "question": "Can the denominator be all zeros?",
             "answer": "No. The denominator coefficient vector must contain at least one non-zero value."
+        },
+        {
+            "question": "Can I use integer coefficients?",
+            "answer": "RunMat mode accepts all eight integer classes when every coefficient is exactly representable as double. MATLAB-compatible mode uses the documented floating coefficient surface."
+        },
+        {
+            "question": "What does `Ts = -1` mean?",
+            "answer": "It creates a discrete-time model whose sample time is unspecified. Continuous-time variables still require `Ts = 0`."
         }
     ],
     "links": [
@@ -141,11 +149,12 @@ const builtinDoc = {
             "output": "H is a tf object."
         },
         "points": [
-            "`tf('s')` and `tf('p')` create continuous-time indeterminates.",
-            "`tf('z', Ts)` and related discrete variables require a positive finite sample time; `tf('z')` defaults to `Ts = 1`.",
+            "`tf('s')` creates a continuous-time indeterminate.",
+            "`tf('z',Ts)` creates a discrete-time indeterminate with a positive sample time or `Ts = -1`.",
             "`num` and `den` are numeric scalar, row-vector, or column-vector coefficient inputs. Coefficients are stored using MATLAB's highest-order-term-first polynomial convention.",
-            "`Ts` is an optional finite non-negative sample time. Positive sample times default the transfer-function variable to `'z'` unless `Variable` is provided explicitly.",
-            "`Variable` accepts `'s'`, `'p'`, `'z'`, `'q'`, `'z^-1'`, or `'q^-1'`. The denominator vector must contain at least one non-zero coefficient.",
+            "`Ts` is `0` for continuous time, positive for a known discrete sample time, or `-1` for an unspecified discrete sample time. Nonzero sample times default the transfer-function variable to `'z'` unless `Variable` is provided explicitly.",
+            "RunMat mode also provides the variable aliases `'p'`, `'q'`, `'z^-1'`, and `'q^-1'`, plus `tf('z')` with a default sample time of 1.",
+            "The denominator vector must contain at least one non-zero coefficient.",
             "SISO `tf` arithmetic supports scalar gains and compatible `tf` operands."
         ]
     },
@@ -156,7 +165,7 @@ const builtinDoc = {
             "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/tf.rs"
         }
     },
-    "gpu_residency": "`tf` is a host-side object constructor. gpuArray coefficient inputs are gathered before object construction, and the returned transfer-function object does not live on the GPU.",
+    "gpu_residency": "`tf` is a host-side object constructor. Automatic residency is gathered transparently; explicit gpuArray input is accepted only in RunMat mode, and the returned object is host-side.",
     "key": "tf",
     "slug": "tf",
     "aliases": [],

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

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

package/dist/generated/builtins/tic.js

@@ -29,11 +29,11 @@ const builtinDoc = {
         "unit": "builtins::timing::tic::tests",
         "integration": "runmat_runtime::io::tests::test_tic_toc"
     },
-    "description": "`tic` starts a high-resolution stopwatch used by `toc` to report elapsed wall-clock seconds. Captured handles from `t = tic` can be passed to `toc(t)` for independent timing scopes, matching MATLAB semantics.",
+    "description": "`tic` starts a high-resolution stopwatch used by `toc` to report elapsed wall-clock seconds. Assign its opaque `uint64` token when you need to measure from a specific start time.",
     "behaviors": [
         "Uses the host's monotonic clock for nanosecond-resolution timing.",
-        "Supports nested timers: each call pushes a new start time on an internal stack. `toc` without inputs always reads the most recent `tic` and removes it, leaving earlier timers intact so outer scopes continue measuring.",
-        "Returns an opaque scalar handle (a `double`) that encodes the monotonic timestamp. The handle can be stored or passed explicitly to `toc`.",
+        "Each call makes its start time the latest stopwatch. `toc` without inputs can read that latest start repeatedly; it does not consume the timer.",
+        "Returns an opaque `uint64` token. The bits identify a monotonic-clock instant and must not be treated as a numeric timestamp or duration.",
         "Executes entirely on the CPU. There are no GPU variants because `tic` interacts with wall-clock state.",
         "Calling `toc` before `tic` raises the MATLAB-compatible error `RunMat:toc:NoMatchingTic`."
     ],
@@ -48,7 +48,7 @@ const builtinDoc = {
         },
         {
             "description": "Nesting timers for staged profiling",
-            "input": "tic;              % Outer stopwatch\nstage1();         % Work you want to measure once\ninner = tic;      % Nested stopwatch\nstage2();\ninnerT = toc(inner);  % Elapsed time for stage2 only\nouterT = toc;         % Elapsed time for everything since the first tic"
+            "input": "outer = tic;      % Keep the outer timer token\nstage1();         % Work you want to measure once\ninner = tic;      % Start a second stopwatch\nstage2();\ninnerT = toc(inner);  % Elapsed time for stage2 only\nouterT = toc(outer);  % Elapsed time for both stages"
         },
         {
             "description": "Measuring asynchronous work",
@@ -70,7 +70,7 @@ const builtinDoc = {
         },
         {
             "question": "Can I run `tic` on a worker thread?",
-            "answer": "Yes. Each thread shares the same stopwatch stack. Nested `tic`/`toc` pairs remain well-defined, but you should serialise access at the script level to avoid interleaving unrelated timings."
+            "answer": "Yes. Stopwatch state is process-wide, so concurrent scripts should retain and pass their own `uint64` tokens when timings might interleave."
         },
         {
             "question": "How accurate is the measurement?",

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

@@ -1 +1 @@
-{"version":3,"file":"tic.js","sourceRoot":"","sources":["../../../src/generated/builtins/tic.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,QAAQ;IACpB,UAAU,EAAE;QACV,KAAK;QACL,OAAO;QACP,SAAS;QACT,WAAW;QACX,aAAa;KACd;IACD,SAAS,EAAE,gGAAgG;IAC3G,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gFAAgF;KAC1F;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,8BAA8B;QACtC,aAAa,EAAE,yCAAyC;KACzD;IACD,aAAa,EAAE,kNAAkN;IACjO,WAAW,EAAE;QACX,mEAAmE;QACnE,2NAA2N;QAC3N,4IAA4I;QAC5I,wGAAwG;QACxG,2FAA2F;KAC5F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,uDAAuD;SACjE;QACD;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,iDAAiD;SAC3D;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,wQAAwQ;SAClR;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,+EAA+E;SACzF;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,mIAAmI;SAC7I;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4DAA4D;YACxE,QAAQ,EAAE,yIAAyI;SACpJ;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,qMAAqM;SAChN;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,8LAA8L;SACzM;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,gPAAgP;SAC3P;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,sMAAsM;SACjN;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,oDAAoD;QAC7D,KAAK,EAAE,iGAAiG;KACzG;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"tic.js","sourceRoot":"","sources":["../../../src/generated/builtins/tic.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,QAAQ;IACpB,UAAU,EAAE;QACV,KAAK;QACL,OAAO;QACP,SAAS;QACT,WAAW;QACX,aAAa;KACd;IACD,SAAS,EAAE,gGAAgG;IAC3G,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gFAAgF;KAC1F;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,8BAA8B;QACtC,aAAa,EAAE,yCAAyC;KACzD;IACD,aAAa,EAAE,oLAAoL;IACnM,WAAW,EAAE;QACX,mEAAmE;QACnE,iJAAiJ;QACjJ,2IAA2I;QAC3I,wGAAwG;QACxG,2FAA2F;KAC5F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,uDAAuD;SACjE;QACD;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,iDAAiD;SAC3D;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,wQAAwQ;SAClR;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,+EAA+E;SACzF;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,mIAAmI;SAC7I;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4DAA4D;YACxE,QAAQ,EAAE,yIAAyI;SACpJ;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,qMAAqM;SAChN;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,6IAA6I;SACxJ;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,gPAAgP;SAC3P;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,sMAAsM;SACjN;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,oDAAoD;QAC7D,KAAK,EAAE,iGAAiG;KACzG;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/timeit.js

@@ -10,7 +10,7 @@ const builtinDoc = {
         "performance",
         "gpu"
     ],
-    "summary": "Measure function-handle execution time by repeated evaluation with MATLAB-compatible `timeit` behavior.",
+    "summary": "Measure function-handle execution time by repeated evaluation.",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
@@ -29,7 +29,7 @@ const builtinDoc = {
         "unit": "builtins::timing::timeit::tests",
         "integration": "builtins::timing::timeit::tests::timeit_measures_time"
     },
-    "description": "`t = timeit(f)` repeatedly evaluates zero-argument function handle `f` and returns timing statistics in seconds. It supports MATLAB-compatible optional output-count control for invoked function calls.",
+    "description": "`t = timeit(f)` repeatedly evaluates zero-argument function handle `f` and returns the median execution time in seconds. The optional output count controls how many outputs are requested from each invocation.",
     "behaviors": [
         "Executes `f` repeatedly, adjusting the inner loop count until a single batch takes at least a few milliseconds or the function is slow enough.",
         "Collects multiple samples (at least seven batches) and returns the median per-invocation time, which is robust against outliers.",
@@ -65,43 +65,43 @@ const builtinDoc = {
     "faqs": [
         {
             "question": "What does `timeit` return?",
-            "answer": "— A scalar double containing the median runtime per invocation in seconds."
+            "answer": "A scalar double containing the median runtime per invocation in seconds."
         },
         {
             "question": "How many runs does `timeit` perform?",
-            "answer": "— It automatically selects a loop count so each batch lasts a few milliseconds, collecting at least seven batches."
+            "answer": "It automatically selects a loop count so each batch lasts a few milliseconds, collecting at least seven batches."
         },
         {
             "question": "Does `timeit` synchronise GPU kernels?",
-            "answer": "— No. Insert `wait(gpuDevice)` inside the handle when you need explicit synchronisation."
+            "answer": "No. Insert `wait(gpuDevice)` inside the handle when you need explicit synchronisation."
         },
         {
             "question": "Can I time functions that require inputs?",
-            "answer": "— Yes. Capture them in the handle, for example `timeit(@() myfun(A, B))`."
+            "answer": "Yes. Capture them in the handle, for example `timeit(@() myfun(A, B))`."
         },
         {
             "question": "How do I time a function with multiple outputs?",
-            "answer": "— Pass `timeit(@() svd(A), 3)` to mirror MATLAB’s call signature. RunMat dispatches the handle with the requested output count and discards returned values."
+            "answer": "Pass `timeit(@() svd(A), 3)`. The runtime requests three outputs from the handle and discards the returned values. Native integer output counts are available in `runmat` compatibility mode."
         },
         {
             "question": "Why do successive runs differ slightly?",
-            "answer": "— Normal system jitter, cache effects, and GPU scheduling can change runtimes slightly; the median mitigates outliers."
+            "answer": "Normal system jitter, cache effects, and GPU scheduling can change runtimes slightly; the median mitigates outliers."
         },
         {
             "question": "Can `timeit` time scripts?",
-            "answer": "— Wrap the script body in a function handle so it becomes zero-argument, then call `timeit` on that handle."
+            "answer": "Wrap the script body in a function handle so it becomes zero-argument, then call `timeit` on that handle."
         },
         {
             "question": "Does `timeit` participate in fusion or JIT tiers?",
-            "answer": "— It simply executes the provided handle; any tiering or fusion happens inside the timed function."
+            "answer": "It executes the provided handle; any tiering or fusion happens inside the timed function."
         },
         {
             "question": "What happens if the function errors?",
-            "answer": "— The error is propagated immediately and timing stops, matching MATLAB behaviour."
+            "answer": "The error is propagated immediately and timing stops."
         },
         {
             "question": "Is there a limit on runs?",
-            "answer": "— Yes. `timeit` caps the inner loop at about one million iterations to avoid runaway measurements."
+            "answer": "Yes. `timeit` caps the inner loop at about one million iterations to avoid runaway measurements."
         }
     ],
     "links": [

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

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

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

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

package/dist/generated/builtins/timer.js

@@ -11,7 +11,7 @@ const builtinDoc = {
         "wait",
         "timerfind"
     ],
-    "summary": "Create a MATLAB-compatible timer handle object.",
+    "summary": "Create a timer handle object for scheduled callbacks.",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
@@ -32,16 +32,18 @@ const builtinDoc = {
             "timer_constructs_finds_starts_and_deletes_through_vm"
         ]
     },
-    "description": "`timer` creates a handle object with MATLAB timer properties and method dispatch for `start`, `startat`, `stop`, `wait`, and `delete`. RunMat stores timers in a per-thread registry so `timerfind` and `timerfindall` can retrieve them while valid.",
+    "description": "`timer` creates a handle object with callback, timing, execution, visibility, and user-data properties. Use `start`, `startat`, `stop`, `wait`, and `delete` to control its lifecycle, and use `timerfind` or `timerfindall` to retrieve valid timers.",
     "behaviors": [
         "`t = timer` creates a valid timer handle with defaults: `ExecutionMode='singleShot'`, `Period=1`, `StartDelay=0`, `TasksToExecute=1`, `BusyMode='drop'`, `ObjectVisibility='on'`, `Running='off'`, `TasksExecuted=0`, `Type='timer'`, and a generated `Name`.",
         "`t = timer(Name, Value, ...)` accepts common callback, timing, labeling, and user-data properties: `TimerFcn`, `StartFcn`, `StopFcn`, `ErrorFcn`, `Period`, `StartDelay`, `TasksToExecute`, `BusyMode`, `ExecutionMode`, `Name`, `Tag`, `ObjectVisibility`, and `UserData`.",
-        "Callback properties accept strings, character rows, function handles, closures, or callback cell arrays for property compatibility. This slice executes function-handle, closure, and callback-cell callbacks; non-empty text callbacks are rejected at execution time because they require dynamic-eval callback infrastructure.",
+        "Callback properties accept strings, character rows, function handles, closures, or callback cell arrays. Function-handle, closure, and callback-cell callbacks execute directly; non-empty text callbacks are not yet executable.",
         "`start(t)` validates `TimerFcn`, marks `Running='on'`, executes `StartFcn`, executes `TimerFcn` once for `singleShot` or `TasksToExecute` times for fixed execution modes, updates `TasksExecuted`, `InstantPeriod`, and `AveragePeriod`, then executes `StopFcn` and marks `Running='off'`.",
         "`startat(t, delaySeconds)` is supported for numeric positive relative delays. MATLAB date/time and date-string start times are not yet implemented.",
         "`stop(t)` marks the timer stopped and runs `StopFcn` if the timer was running. `wait(t)` returns after the timer is stopped. `delete(t)` invalidates the handle, removes it from timer discovery, and releases its GC root.",
-        "RunMat executes timer callbacks synchronously on the current VM path rather than on a background event queue. Long delays therefore block the caller on native hosts. This preserves deterministic behavior across native and wasm hosts, but it is not full MATLAB asynchronous scheduling.",
-        "Multiple timers are represented as a cell row because RunMat does not yet have first-class MATLAB object arrays."
+        "Timer callbacks currently run synchronously on the current VM path. Long delays therefore block the caller on native hosts; background event-queue scheduling is not yet available.",
+        "`TasksToExecute` retains a native integer scalar exactly. `Period` and `StartDelay` are stored as seconds and reject integer values that cannot cross the binary64 seconds boundary exactly.",
+        "`UserData` preserves native integer class, shape, and payload without numeric conversion.",
+        "Multiple timers are currently returned as a cell row."
     ],
     "examples": [
         {
@@ -56,7 +58,7 @@ const builtinDoc = {
     "faqs": [
         {
             "question": "Does RunMat run timers in the background?",
-            "answer": "No. Timer callbacks run synchronously when `start` drives the timer. Background scheduling and a MATLAB-compatible timer event queue require additional runtime infrastructure."
+            "answer": "No. Timer callbacks run synchronously when `start` drives the timer. Background scheduling requires an event queue that is not yet available."
         },
         {
             "question": "Can timer callbacks use GPU arrays?",

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

@@ -1 +1 @@
-{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../../src/generated/builtins/timer.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,QAAQ;IACpB,UAAU,EAAE;QACV,OAAO;QACP,UAAU;QACV,OAAO;QACP,MAAM;QACN,MAAM;QACN,WAAW;KACZ;IACD,SAAS,EAAE,iDAAiD;IAC5D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,kKAAkK;KAC5K;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,gCAAgC;QACxC,aAAa,EAAE;YACb,sDAAsD;SACvD;KACF;IACD,aAAa,EAAE,uPAAuP;IACtQ,WAAW,EAAE;QACX,+PAA+P;QAC/P,6QAA6Q;QAC7Q,mUAAmU;QACnU,8RAA8R;QAC9R,qJAAqJ;QACrJ,6NAA6N;QAC7N,8RAA8R;QAC9R,kHAAkH;KACnH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,6DAA6D;SACvE;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,kFAAkF;SAC5F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,iLAAiL;SAC5L;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,kIAAkI;SAC7I;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,cAAc,EAAE;QACd,qIAAqI;KACtI;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../../src/generated/builtins/timer.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,QAAQ;IACpB,UAAU,EAAE;QACV,OAAO;QACP,UAAU;QACV,OAAO;QACP,MAAM;QACN,MAAM;QACN,WAAW;KACZ;IACD,SAAS,EAAE,uDAAuD;IAClE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,kKAAkK;KAC5K;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,gCAAgC;QACxC,aAAa,EAAE;YACb,sDAAsD;SACvD;KACF;IACD,aAAa,EAAE,wPAAwP;IACvQ,WAAW,EAAE;QACX,+PAA+P;QAC/P,6QAA6Q;QAC7Q,mOAAmO;QACnO,8RAA8R;QAC9R,qJAAqJ;QACrJ,6NAA6N;QAC7N,qLAAqL;QACrL,8LAA8L;QAC9L,2FAA2F;QAC3F,uDAAuD;KACxD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,6DAA6D;SACvE;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,kFAAkF;SAC5F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,+IAA+I;SAC1J;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,kIAAkI;SAC7I;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,cAAc,EAAE;QACd,qIAAqI;KACtI;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}