[{"data":1,"prerenderedAt":1284},["ShallowReactive",2],{"kscript:releases/overview":3},{"slug":4,"filePath":5,"frontmatter":6,"rawMarkdown":9,"tree":10},"releases/overview","releases/overview.md",{"title":7,"description":8},"Overview","How kScript versions are documented, what to expect in each release entry, and where to find migration context when upgrading from older language versions.","---\ntitle: Overview\ndescription: >-\n  How kScript versions are documented, what to expect in each release entry,\n  and where to find migration context when upgrading from older language\n  versions.\n---\n\nRelease notes document **what changed** in kScript as it ships on the OpenMarket platform: new language features, fixes, performance work, and any **breaking changes** that may require you to update scripts.\n\nThey are written for **script authors** first—concrete behavior changes and upgrade impact—not internal implementation detail.\n\n## What we publish\n\n| Artifact                                      | Purpose                                                                                                                |\n| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |\n| [Release Notes](/kscript/releases/changelog) | Version-by-version history: highlights, grouped changes, and breaking-change callouts.                               |\n| [Migration (v1 vs v2)](/kscript/migrations/v1-vs-v2) | **Migrate** from **v1** to **v2**—conceptual differences. Not release history—use [Release Notes](/kscript/releases/changelog). |\n| [Migration (v2 vs v3)](/kscript/migrations/v2-vs-v3) | **Migrate** from **v2** to **v3**: the version marker, corrected TA warmups, and what got stricter. Not release history: use [Release Notes](/kscript/releases/changelog). |\n\nNew work is listed in Release Notes **newest first**. Each entry uses a short **headline** plus sections such as **Added**, **Changed**, **Fixed**, and **Breaking changes** so you can scan quickly.\n\n## Versioning\n\nkScript releases are identified by **semantic-style version numbers** (`MAJOR.MINOR.PATCH`):\n\n- **MAJOR** — Breaking language or runtime behavior, or removals that require script changes.\n- **MINOR** — New features or compatible improvements.\n- **PATCH** — Bug fixes and small compatible adjustments.\n\nWhen a release includes breaking changes, its **Release Notes** entry calls them out explicitly and points to relevant manual sections where possible.\n\n## Upgrade checklist\n\nThe `//@version` marker is a **language-generation marker, not a release number**: `//@version=2` and `//@version=3` are both accepted and select the same modern engine (see [v2 vs v3](/kscript/migrations/v2-vs-v3)), so a newer runtime never requires bumping it. What the marker must never be is missing or `//@version=1`; both route the script to the deprecated legacy v1 engine. When you redeploy scripts against a newer runtime:\n\n1. Read the **Latest release** callout at the top of [Release Notes](/kscript/releases/changelog).\n2. Scan **Breaking changes** for your current and target versions.\n3. Re-compile scripts in the editor and fix any **compile-time** errors first (v2 favors early errors over runtime surprises).\n4. Validate indicators on historical and live data where behavior may depend on timing or data subscriptions.\n\n{% hint style=\"info\" %}\n**Docs vs platform:** Published dates reflect when changes reached the documentation snapshot; your organization’s rollout timing may trail or lead **Release Notes** slightly. Treat **Release Notes** as the authoritative _behavior_ list for a given version tag.\n{% endhint %}\n",{"type":11,"children":12,"data":1277,"position":1279},"root",[13,80,82,118,119,138,140,509,510,656,657,674,675,732,733,833,834,869,870,885,886,1026,1027,1179,1180],{"type":14,"tagName":15,"properties":16,"children":17,"position":77},"element","p",{},[18,28,46,53,70],{"type":19,"value":20,"position":21},"text","Release notes document ",{"start":22,"end":25},{"line":23,"column":23,"offset":24},1,0,{"line":23,"column":26,"offset":27},24,23,{"type":14,"tagName":29,"properties":30,"children":31,"position":41},"strong",{},[32],{"type":19,"value":33,"position":34},"what changed",{"start":35,"end":38},{"line":23,"column":36,"offset":37},26,25,{"line":23,"column":39,"offset":40},38,37,{"start":42,"end":43},{"line":23,"column":26,"offset":27},{"line":23,"column":44,"offset":45},40,39,{"type":19,"value":47,"position":48}," in kScript as it ships on the OpenMarket platform: new language features, fixes, performance work, and any ",{"start":49,"end":50},{"line":23,"column":44,"offset":45},{"line":23,"column":51,"offset":52},148,147,{"type":14,"tagName":29,"properties":54,"children":55,"position":65},{},[56],{"type":19,"value":57,"position":58},"breaking changes",{"start":59,"end":62},{"line":23,"column":60,"offset":61},150,149,{"line":23,"column":63,"offset":64},166,165,{"start":66,"end":67},{"line":23,"column":51,"offset":52},{"line":23,"column":68,"offset":69},168,167,{"type":19,"value":71,"position":72}," that may require you to update scripts.",{"start":73,"end":74},{"line":23,"column":68,"offset":69},{"line":23,"column":75,"offset":76},208,207,{"start":78,"end":79},{"line":23,"column":23,"offset":24},{"line":23,"column":75,"offset":76},{"type":19,"value":81},"\n",{"type":14,"tagName":15,"properties":83,"children":84,"position":115},{},[85,94,108],{"type":19,"value":86,"position":87},"They are written for ",{"start":88,"end":91},{"line":89,"column":23,"offset":90},3,209,{"line":89,"column":92,"offset":93},22,230,{"type":14,"tagName":29,"properties":95,"children":96,"position":104},{},[97],{"type":19,"value":98,"position":99},"script authors",{"start":100,"end":102},{"line":89,"column":26,"offset":101},232,{"line":89,"column":39,"offset":103},246,{"start":105,"end":106},{"line":89,"column":92,"offset":93},{"line":89,"column":44,"offset":107},248,{"type":19,"value":109,"position":110}," first—concrete behavior changes and upgrade impact—not internal implementation detail.",{"start":111,"end":112},{"line":89,"column":44,"offset":107},{"line":89,"column":113,"offset":114},127,335,{"start":116,"end":117},{"line":89,"column":23,"offset":90},{"line":89,"column":113,"offset":114},{"type":19,"value":81},{"type":14,"tagName":120,"properties":121,"children":123,"position":134},"h2",{"id":122},"what-we-publish",[124],{"type":19,"value":125,"position":126},"What we publish",{"start":127,"end":131},{"line":128,"column":129,"offset":130},5,4,340,{"line":128,"column":132,"offset":133},19,355,{"start":135,"end":137},{"line":128,"column":23,"offset":136},337,{"line":128,"column":132,"offset":133},{"type":19,"value":139},"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",{"type":14,"tagName":141,"properties":142,"children":143,"position":506},"table",{},[144,194],{"type":14,"tagName":145,"properties":146,"children":147,"position":191},"thead",{},[148],{"type":14,"tagName":149,"properties":150,"children":151,"position":188},"tr",{},[152,171],{"type":14,"tagName":153,"properties":154,"children":155,"position":165},"th",{},[156],{"type":19,"value":157,"position":158},"Artifact",{"start":159,"end":162},{"line":160,"column":89,"offset":161},7,359,{"line":160,"column":163,"offset":164},11,367,{"start":166,"end":168},{"line":160,"column":23,"offset":167},357,{"line":160,"column":169,"offset":170},49,405,{"type":14,"tagName":153,"properties":172,"children":173,"position":183},{},[174],{"type":19,"value":175,"position":176},"Purpose",{"start":177,"end":180},{"line":160,"column":178,"offset":179},51,407,{"line":160,"column":181,"offset":182},58,414,{"start":184,"end":185},{"line":160,"column":169,"offset":170},{"line":160,"column":186,"offset":187},171,527,{"start":189,"end":190},{"line":160,"column":23,"offset":167},{"line":160,"column":186,"offset":187},{"start":192,"end":193},{"line":160,"column":23,"offset":167},{"line":160,"column":186,"offset":187},{"type":14,"tagName":195,"properties":196,"children":197,"position":503},"tbody",{},[198,250,387],{"type":14,"tagName":149,"properties":199,"children":200,"position":247},{},[201,231],{"type":14,"tagName":202,"properties":203,"children":204,"position":225},"td",{},[205],{"type":14,"tagName":206,"properties":207,"children":209,"position":219},"a",{"href":208},"/kscript/releases/changelog",[210],{"type":19,"value":211,"position":212},"Release Notes",{"start":213,"end":216},{"line":214,"column":129,"offset":215},9,702,{"line":214,"column":217,"offset":218},17,715,{"start":220,"end":222},{"line":214,"column":89,"offset":221},701,{"line":214,"column":223,"offset":224},47,745,{"start":226,"end":228},{"line":214,"column":23,"offset":227},699,{"line":214,"column":229,"offset":230},48,746,{"type":14,"tagName":202,"properties":232,"children":233,"position":243},{},[234],{"type":19,"value":235,"position":236},"Version-by-version history: highlights, grouped changes, and breaking-change callouts.",{"start":237,"end":240},{"line":214,"column":238,"offset":239},50,748,{"line":214,"column":241,"offset":242},136,834,{"start":244,"end":245},{"line":214,"column":229,"offset":230},{"line":214,"column":68,"offset":246},866,{"start":248,"end":249},{"line":214,"column":23,"offset":227},{"line":214,"column":68,"offset":246},{"type":14,"tagName":149,"properties":251,"children":252,"position":384},{},[253,280],{"type":14,"tagName":202,"properties":254,"children":255,"position":274},{},[256],{"type":14,"tagName":206,"properties":257,"children":259,"position":268},{"href":258},"/kscript/migrations/v1-vs-v2",[260],{"type":19,"value":261,"position":262},"Migration (v1 vs v2)",{"start":263,"end":266},{"line":264,"column":129,"offset":265},10,870,{"line":264,"column":26,"offset":267},890,{"start":269,"end":271},{"line":264,"column":89,"offset":270},869,{"line":264,"column":272,"offset":273},55,921,{"start":275,"end":277},{"line":264,"column":23,"offset":276},867,{"line":264,"column":278,"offset":279},56,922,{"type":14,"tagName":202,"properties":281,"children":282,"position":379},{},[283,301,308,325,332,349,356,372],{"type":14,"tagName":29,"properties":284,"children":285,"position":295},{},[286],{"type":19,"value":287,"position":288},"Migrate",{"start":289,"end":292},{"line":264,"column":290,"offset":291},60,926,{"line":264,"column":293,"offset":294},67,933,{"start":296,"end":298},{"line":264,"column":181,"offset":297},924,{"line":264,"column":299,"offset":300},69,935,{"type":19,"value":302,"position":303}," from ",{"start":304,"end":305},{"line":264,"column":299,"offset":300},{"line":264,"column":306,"offset":307},75,941,{"type":14,"tagName":29,"properties":309,"children":310,"position":320},{},[311],{"type":19,"value":312,"position":313},"v1",{"start":314,"end":317},{"line":264,"column":315,"offset":316},77,943,{"line":264,"column":318,"offset":319},79,945,{"start":321,"end":322},{"line":264,"column":306,"offset":307},{"line":264,"column":323,"offset":324},81,947,{"type":19,"value":326,"position":327}," to ",{"start":328,"end":329},{"line":264,"column":323,"offset":324},{"line":264,"column":330,"offset":331},85,951,{"type":14,"tagName":29,"properties":333,"children":334,"position":344},{},[335],{"type":19,"value":336,"position":337},"v2",{"start":338,"end":341},{"line":264,"column":339,"offset":340},87,953,{"line":264,"column":342,"offset":343},89,955,{"start":345,"end":346},{"line":264,"column":330,"offset":331},{"line":264,"column":347,"offset":348},91,957,{"type":19,"value":350,"position":351},"—conceptual differences. Not release history—use ",{"start":352,"end":353},{"line":264,"column":347,"offset":348},{"line":264,"column":354,"offset":355},140,1006,{"type":14,"tagName":206,"properties":357,"children":358,"position":367},{"href":208},[359],{"type":19,"value":211,"position":360},{"start":361,"end":364},{"line":264,"column":362,"offset":363},141,1007,{"line":264,"column":365,"offset":366},154,1020,{"start":368,"end":369},{"line":264,"column":354,"offset":355},{"line":264,"column":370,"offset":371},184,1050,{"type":19,"value":373,"position":374},".",{"start":375,"end":376},{"line":264,"column":370,"offset":371},{"line":264,"column":377,"offset":378},185,1051,{"start":380,"end":381},{"line":264,"column":278,"offset":279},{"line":264,"column":382,"offset":383},187,1053,{"start":385,"end":386},{"line":264,"column":23,"offset":276},{"line":264,"column":382,"offset":383},{"type":14,"tagName":149,"properties":388,"children":389,"position":500},{},[390,414],{"type":14,"tagName":202,"properties":391,"children":392,"position":409},{},[393],{"type":14,"tagName":206,"properties":394,"children":396,"position":404},{"href":395},"/kscript/migrations/v2-vs-v3",[397],{"type":19,"value":398,"position":399},"Migration (v2 vs v3)",{"start":400,"end":402},{"line":163,"column":129,"offset":401},1057,{"line":163,"column":26,"offset":403},1077,{"start":405,"end":407},{"line":163,"column":89,"offset":406},1056,{"line":163,"column":272,"offset":408},1108,{"start":410,"end":412},{"line":163,"column":23,"offset":411},1054,{"line":163,"column":278,"offset":413},1109,{"type":14,"tagName":202,"properties":415,"children":416,"position":496},{},[417,431,436,449,454,468,475,490],{"type":14,"tagName":29,"properties":418,"children":419,"position":426},{},[420],{"type":19,"value":287,"position":421},{"start":422,"end":424},{"line":163,"column":290,"offset":423},1113,{"line":163,"column":293,"offset":425},1120,{"start":427,"end":429},{"line":163,"column":181,"offset":428},1111,{"line":163,"column":299,"offset":430},1122,{"type":19,"value":302,"position":432},{"start":433,"end":434},{"line":163,"column":299,"offset":430},{"line":163,"column":306,"offset":435},1128,{"type":14,"tagName":29,"properties":437,"children":438,"position":445},{},[439],{"type":19,"value":336,"position":440},{"start":441,"end":443},{"line":163,"column":315,"offset":442},1130,{"line":163,"column":318,"offset":444},1132,{"start":446,"end":447},{"line":163,"column":306,"offset":435},{"line":163,"column":323,"offset":448},1134,{"type":19,"value":326,"position":450},{"start":451,"end":452},{"line":163,"column":323,"offset":448},{"line":163,"column":330,"offset":453},1138,{"type":14,"tagName":29,"properties":455,"children":456,"position":464},{},[457],{"type":19,"value":458,"position":459},"v3",{"start":460,"end":462},{"line":163,"column":339,"offset":461},1140,{"line":163,"column":342,"offset":463},1142,{"start":465,"end":466},{"line":163,"column":330,"offset":453},{"line":163,"column":347,"offset":467},1144,{"type":19,"value":469,"position":470},": the version marker, corrected TA warmups, and what got stricter. Not release history: use ",{"start":471,"end":472},{"line":163,"column":347,"offset":467},{"line":163,"column":473,"offset":474},183,1236,{"type":14,"tagName":206,"properties":476,"children":477,"position":485},{"href":208},[478],{"type":19,"value":211,"position":479},{"start":480,"end":482},{"line":163,"column":370,"offset":481},1237,{"line":163,"column":483,"offset":484},197,1250,{"start":486,"end":487},{"line":163,"column":473,"offset":474},{"line":163,"column":488,"offset":489},227,1280,{"type":19,"value":373,"position":491},{"start":492,"end":493},{"line":163,"column":488,"offset":489},{"line":163,"column":494,"offset":495},228,1281,{"start":497,"end":498},{"line":163,"column":278,"offset":413},{"line":163,"column":93,"offset":499},1283,{"start":501,"end":502},{"line":163,"column":23,"offset":411},{"line":163,"column":93,"offset":499},{"start":504,"end":505},{"line":214,"column":23,"offset":227},{"line":163,"column":93,"offset":499},{"start":507,"end":508},{"line":160,"column":23,"offset":167},{"line":163,"column":93,"offset":499},{"type":19,"value":81},{"type":14,"tagName":15,"properties":511,"children":512,"position":653},{},[513,521,536,542,556,563,580,587,602,608,623,630,646],{"type":19,"value":514,"position":515},"New work is listed in Release Notes ",{"start":516,"end":519},{"line":517,"column":23,"offset":518},13,1285,{"line":517,"column":40,"offset":520},1321,{"type":14,"tagName":29,"properties":522,"children":523,"position":531},{},[524],{"type":19,"value":525,"position":526},"newest first",{"start":527,"end":529},{"line":517,"column":45,"offset":528},1323,{"line":517,"column":178,"offset":530},1335,{"start":532,"end":533},{"line":517,"column":40,"offset":520},{"line":517,"column":534,"offset":535},53,1337,{"type":19,"value":537,"position":538},". Each entry uses a short ",{"start":539,"end":540},{"line":517,"column":534,"offset":535},{"line":517,"column":318,"offset":541},1363,{"type":14,"tagName":29,"properties":543,"children":544,"position":552},{},[545],{"type":19,"value":546,"position":547},"headline",{"start":548,"end":550},{"line":517,"column":323,"offset":549},1365,{"line":517,"column":342,"offset":551},1373,{"start":553,"end":554},{"line":517,"column":318,"offset":541},{"line":517,"column":347,"offset":555},1375,{"type":19,"value":557,"position":558}," plus sections such as ",{"start":559,"end":560},{"line":517,"column":347,"offset":555},{"line":517,"column":561,"offset":562},114,1398,{"type":14,"tagName":29,"properties":564,"children":565,"position":575},{},[566],{"type":19,"value":567,"position":568},"Added",{"start":569,"end":572},{"line":517,"column":570,"offset":571},116,1400,{"line":517,"column":573,"offset":574},121,1405,{"start":576,"end":577},{"line":517,"column":561,"offset":562},{"line":517,"column":578,"offset":579},123,1407,{"type":19,"value":581,"position":582},", ",{"start":583,"end":584},{"line":517,"column":578,"offset":579},{"line":517,"column":585,"offset":586},125,1409,{"type":14,"tagName":29,"properties":588,"children":589,"position":598},{},[590],{"type":19,"value":591,"position":592},"Changed",{"start":593,"end":595},{"line":517,"column":113,"offset":594},1411,{"line":517,"column":596,"offset":597},134,1418,{"start":599,"end":600},{"line":517,"column":585,"offset":586},{"line":517,"column":241,"offset":601},1420,{"type":19,"value":581,"position":603},{"start":604,"end":605},{"line":517,"column":241,"offset":601},{"line":517,"column":606,"offset":607},138,1422,{"type":14,"tagName":29,"properties":609,"children":610,"position":619},{},[611],{"type":19,"value":612,"position":613},"Fixed",{"start":614,"end":616},{"line":517,"column":354,"offset":615},1424,{"line":517,"column":617,"offset":618},145,1429,{"start":620,"end":621},{"line":517,"column":606,"offset":607},{"line":517,"column":52,"offset":622},1431,{"type":19,"value":624,"position":625},", and ",{"start":626,"end":627},{"line":517,"column":52,"offset":622},{"line":517,"column":628,"offset":629},153,1437,{"type":14,"tagName":29,"properties":631,"children":632,"position":641},{},[633],{"type":19,"value":634,"position":635},"Breaking changes",{"start":636,"end":639},{"line":517,"column":637,"offset":638},155,1439,{"line":517,"column":186,"offset":640},1455,{"start":642,"end":643},{"line":517,"column":628,"offset":629},{"line":517,"column":644,"offset":645},173,1457,{"type":19,"value":647,"position":648}," so you can scan quickly.",{"start":649,"end":650},{"line":517,"column":644,"offset":645},{"line":517,"column":651,"offset":652},198,1482,{"start":654,"end":655},{"line":517,"column":23,"offset":518},{"line":517,"column":651,"offset":652},{"type":19,"value":81},{"type":14,"tagName":120,"properties":658,"children":660,"position":670},{"id":659},"versioning",[661],{"type":19,"value":662,"position":663},"Versioning",{"start":664,"end":667},{"line":665,"column":129,"offset":666},15,1487,{"line":665,"column":668,"offset":669},14,1497,{"start":671,"end":673},{"line":665,"column":23,"offset":672},1484,{"line":665,"column":668,"offset":669},{"type":19,"value":81},{"type":14,"tagName":15,"properties":676,"children":677,"position":729},{},[678,686,702,709,722],{"type":19,"value":679,"position":680},"kScript releases are identified by ",{"start":681,"end":683},{"line":217,"column":23,"offset":682},1499,{"line":217,"column":684,"offset":685},36,1534,{"type":14,"tagName":29,"properties":687,"children":688,"position":697},{},[689],{"type":19,"value":690,"position":691},"semantic-style version numbers",{"start":692,"end":694},{"line":217,"column":39,"offset":693},1536,{"line":217,"column":695,"offset":696},68,1566,{"start":698,"end":699},{"line":217,"column":684,"offset":685},{"line":217,"column":700,"offset":701},70,1568,{"type":19,"value":703,"position":704}," (",{"start":705,"end":706},{"line":217,"column":700,"offset":701},{"line":217,"column":707,"offset":708},72,1570,{"type":14,"tagName":710,"properties":711,"children":712,"position":719},"code",{},[713],{"type":19,"value":714,"position":715},"MAJOR.MINOR.PATCH",{"start":716,"end":717},{"line":217,"column":707,"offset":708},{"line":217,"column":347,"offset":718},1589,{"start":720,"end":721},{"line":217,"column":707,"offset":708},{"line":217,"column":347,"offset":718},{"type":19,"value":723,"position":724},"):",{"start":725,"end":726},{"line":217,"column":347,"offset":718},{"line":217,"column":727,"offset":728},93,1591,{"start":730,"end":731},{"line":217,"column":23,"offset":682},{"line":217,"column":727,"offset":728},{"type":19,"value":81},{"type":14,"tagName":734,"properties":735,"children":736,"position":830},"ul",{},[737,738,769,770,799,800,829],{"type":19,"value":81},{"type":14,"tagName":739,"properties":740,"children":741,"position":765},"li",{},[742,758],{"type":14,"tagName":29,"properties":743,"children":744,"position":752},{},[745],{"type":19,"value":746,"position":747},"MAJOR",{"start":748,"end":750},{"line":132,"column":128,"offset":749},1597,{"line":132,"column":264,"offset":751},1602,{"start":753,"end":755},{"line":132,"column":89,"offset":754},1595,{"line":132,"column":756,"offset":757},12,1604,{"type":19,"value":759,"position":760}," — Breaking language or runtime behavior, or removals that require script changes.",{"start":761,"end":762},{"line":132,"column":756,"offset":757},{"line":132,"column":763,"offset":764},94,1686,{"start":766,"end":768},{"line":132,"column":23,"offset":767},1593,{"line":132,"column":763,"offset":764},{"type":19,"value":81},{"type":14,"tagName":739,"properties":771,"children":772,"position":795},{},[773,789],{"type":14,"tagName":29,"properties":774,"children":775,"position":784},{},[776],{"type":19,"value":777,"position":778},"MINOR",{"start":779,"end":782},{"line":780,"column":128,"offset":781},20,1691,{"line":780,"column":264,"offset":783},1696,{"start":785,"end":787},{"line":780,"column":89,"offset":786},1689,{"line":780,"column":756,"offset":788},1698,{"type":19,"value":790,"position":791}," — New features or compatible improvements.",{"start":792,"end":793},{"line":780,"column":756,"offset":788},{"line":780,"column":272,"offset":794},1741,{"start":796,"end":798},{"line":780,"column":23,"offset":797},1687,{"line":780,"column":272,"offset":794},{"type":19,"value":81},{"type":14,"tagName":739,"properties":801,"children":802,"position":825},{},[803,819],{"type":14,"tagName":29,"properties":804,"children":805,"position":814},{},[806],{"type":19,"value":807,"position":808},"PATCH",{"start":809,"end":812},{"line":810,"column":128,"offset":811},21,1746,{"line":810,"column":264,"offset":813},1751,{"start":815,"end":817},{"line":810,"column":89,"offset":816},1744,{"line":810,"column":756,"offset":818},1753,{"type":19,"value":820,"position":821}," — Bug fixes and small compatible adjustments.",{"start":822,"end":823},{"line":810,"column":756,"offset":818},{"line":810,"column":181,"offset":824},1799,{"start":826,"end":828},{"line":810,"column":23,"offset":827},1742,{"line":810,"column":181,"offset":824},{"type":19,"value":81},{"start":831,"end":832},{"line":132,"column":23,"offset":767},{"line":810,"column":181,"offset":824},{"type":19,"value":81},{"type":14,"tagName":15,"properties":835,"children":836,"position":866},{},[837,844,859],{"type":19,"value":838,"position":839},"When a release includes breaking changes, its ",{"start":840,"end":842},{"line":27,"column":23,"offset":841},1801,{"line":27,"column":223,"offset":843},1847,{"type":14,"tagName":29,"properties":845,"children":846,"position":854},{},[847],{"type":19,"value":211,"position":848},{"start":849,"end":851},{"line":27,"column":169,"offset":850},1849,{"line":27,"column":852,"offset":853},62,1862,{"start":855,"end":856},{"line":27,"column":223,"offset":843},{"line":27,"column":857,"offset":858},64,1864,{"type":19,"value":860,"position":861}," entry calls them out explicitly and points to relevant manual sections where possible.",{"start":862,"end":863},{"line":27,"column":857,"offset":858},{"line":27,"column":864,"offset":865},151,1951,{"start":867,"end":868},{"line":27,"column":23,"offset":841},{"line":27,"column":864,"offset":865},{"type":19,"value":81},{"type":14,"tagName":120,"properties":871,"children":873,"position":881},{"id":872},"upgrade-checklist",[874],{"type":19,"value":875,"position":876},"Upgrade checklist",{"start":877,"end":879},{"line":37,"column":129,"offset":878},1956,{"line":37,"column":810,"offset":880},1973,{"start":882,"end":884},{"line":37,"column":23,"offset":883},1953,{"line":37,"column":810,"offset":880},{"type":19,"value":81},{"type":14,"tagName":15,"properties":887,"children":888,"position":1023},{},[889,897,909,916,933,940,953,960,973,980,996,1003,1016],{"type":19,"value":890,"position":891},"The ",{"start":892,"end":895},{"line":893,"column":23,"offset":894},27,1975,{"line":893,"column":128,"offset":896},1979,{"type":14,"tagName":710,"properties":898,"children":899,"position":906},{},[900],{"type":19,"value":901,"position":902},"//@version",{"start":903,"end":904},{"line":893,"column":128,"offset":896},{"line":893,"column":217,"offset":905},1991,{"start":907,"end":908},{"line":893,"column":128,"offset":896},{"line":893,"column":217,"offset":905},{"type":19,"value":910,"position":911}," marker is a ",{"start":912,"end":913},{"line":893,"column":217,"offset":905},{"line":893,"column":914,"offset":915},30,2004,{"type":14,"tagName":29,"properties":917,"children":918,"position":928},{},[919],{"type":19,"value":920,"position":921},"language-generation marker, not a release number",{"start":922,"end":925},{"line":893,"column":923,"offset":924},32,2006,{"line":893,"column":926,"offset":927},80,2054,{"start":929,"end":930},{"line":893,"column":914,"offset":915},{"line":893,"column":931,"offset":932},82,2056,{"type":19,"value":934,"position":935},": ",{"start":936,"end":937},{"line":893,"column":931,"offset":932},{"line":893,"column":938,"offset":939},84,2058,{"type":14,"tagName":710,"properties":941,"children":942,"position":950},{},[943],{"type":19,"value":944,"position":945},"//@version=2",{"start":946,"end":947},{"line":893,"column":938,"offset":939},{"line":893,"column":948,"offset":949},98,2072,{"start":951,"end":952},{"line":893,"column":938,"offset":939},{"line":893,"column":948,"offset":949},{"type":19,"value":954,"position":955}," and ",{"start":956,"end":957},{"line":893,"column":948,"offset":949},{"line":893,"column":958,"offset":959},103,2077,{"type":14,"tagName":710,"properties":961,"children":962,"position":970},{},[963],{"type":19,"value":964,"position":965},"//@version=3",{"start":966,"end":967},{"line":893,"column":958,"offset":959},{"line":893,"column":968,"offset":969},117,2091,{"start":971,"end":972},{"line":893,"column":958,"offset":959},{"line":893,"column":968,"offset":969},{"type":19,"value":974,"position":975}," are both accepted and select the same modern engine (see ",{"start":976,"end":977},{"line":893,"column":968,"offset":969},{"line":893,"column":978,"offset":979},175,2149,{"type":14,"tagName":206,"properties":981,"children":982,"position":991},{"href":395},[983],{"type":19,"value":984,"position":985},"v2 vs v3",{"start":986,"end":989},{"line":893,"column":987,"offset":988},176,2150,{"line":893,"column":370,"offset":990},2158,{"start":992,"end":993},{"line":893,"column":978,"offset":979},{"line":893,"column":994,"offset":995},215,2189,{"type":19,"value":997,"position":998},"), so a newer runtime never requires bumping it. What the marker must never be is missing or ",{"start":999,"end":1000},{"line":893,"column":994,"offset":995},{"line":893,"column":1001,"offset":1002},308,2282,{"type":14,"tagName":710,"properties":1004,"children":1005,"position":1013},{},[1006],{"type":19,"value":1007,"position":1008},"//@version=1",{"start":1009,"end":1010},{"line":893,"column":1001,"offset":1002},{"line":893,"column":1011,"offset":1012},322,2296,{"start":1014,"end":1015},{"line":893,"column":1001,"offset":1002},{"line":893,"column":1011,"offset":1012},{"type":19,"value":1017,"position":1018},"; both route the script to the deprecated legacy v1 engine. When you redeploy scripts against a newer runtime:",{"start":1019,"end":1020},{"line":893,"column":1011,"offset":1012},{"line":893,"column":1021,"offset":1022},432,2406,{"start":1024,"end":1025},{"line":893,"column":23,"offset":894},{"line":893,"column":1021,"offset":1022},{"type":19,"value":81},{"type":14,"tagName":1028,"properties":1029,"children":1030,"position":1176},"ol",{},[1031,1032,1088,1089,1122,1123,1159,1160,1175],{"type":19,"value":81},{"type":14,"tagName":739,"properties":1033,"children":1034,"position":1084},{},[1035,1043,1058,1065,1078],{"type":19,"value":1036,"position":1037},"Read the ",{"start":1038,"end":1041},{"line":1039,"column":129,"offset":1040},29,2411,{"line":1039,"column":517,"offset":1042},2420,{"type":14,"tagName":29,"properties":1044,"children":1045,"position":1053},{},[1046],{"type":19,"value":1047,"position":1048},"Latest release",{"start":1049,"end":1051},{"line":1039,"column":665,"offset":1050},2422,{"line":1039,"column":1039,"offset":1052},2436,{"start":1054,"end":1055},{"line":1039,"column":517,"offset":1042},{"line":1039,"column":1056,"offset":1057},31,2438,{"type":19,"value":1059,"position":1060}," callout at the top of ",{"start":1061,"end":1062},{"line":1039,"column":1056,"offset":1057},{"line":1039,"column":1063,"offset":1064},54,2461,{"type":14,"tagName":206,"properties":1066,"children":1067,"position":1074},{"href":208},[1068],{"type":19,"value":211,"position":1069},{"start":1070,"end":1072},{"line":1039,"column":272,"offset":1071},2462,{"line":1039,"column":695,"offset":1073},2475,{"start":1075,"end":1076},{"line":1039,"column":1063,"offset":1064},{"line":1039,"column":948,"offset":1077},2505,{"type":19,"value":373,"position":1079},{"start":1080,"end":1081},{"line":1039,"column":948,"offset":1077},{"line":1039,"column":1082,"offset":1083},99,2506,{"start":1085,"end":1087},{"line":1039,"column":23,"offset":1086},2408,{"line":1039,"column":1082,"offset":1083},{"type":19,"value":81},{"type":14,"tagName":739,"properties":1090,"children":1091,"position":1118},{},[1092,1099,1112],{"type":19,"value":1093,"position":1094},"Scan ",{"start":1095,"end":1097},{"line":914,"column":129,"offset":1096},2510,{"line":914,"column":214,"offset":1098},2515,{"type":14,"tagName":29,"properties":1100,"children":1101,"position":1108},{},[1102],{"type":19,"value":634,"position":1103},{"start":1104,"end":1106},{"line":914,"column":163,"offset":1105},2517,{"line":914,"column":893,"offset":1107},2533,{"start":1109,"end":1110},{"line":914,"column":214,"offset":1098},{"line":914,"column":1039,"offset":1111},2535,{"type":19,"value":1113,"position":1114}," for your current and target versions.",{"start":1115,"end":1116},{"line":914,"column":1039,"offset":1111},{"line":914,"column":293,"offset":1117},2573,{"start":1119,"end":1121},{"line":914,"column":23,"offset":1120},2507,{"line":914,"column":293,"offset":1117},{"type":19,"value":81},{"type":14,"tagName":739,"properties":1124,"children":1125,"position":1155},{},[1126,1133,1149],{"type":19,"value":1127,"position":1128},"Re-compile scripts in the editor and fix any ",{"start":1129,"end":1131},{"line":1056,"column":129,"offset":1130},2577,{"line":1056,"column":169,"offset":1132},2622,{"type":14,"tagName":29,"properties":1134,"children":1135,"position":1144},{},[1136],{"type":19,"value":1137,"position":1138},"compile-time",{"start":1139,"end":1141},{"line":1056,"column":178,"offset":1140},2624,{"line":1056,"column":1142,"offset":1143},63,2636,{"start":1145,"end":1146},{"line":1056,"column":169,"offset":1132},{"line":1056,"column":1147,"offset":1148},65,2638,{"type":19,"value":1150,"position":1151}," errors first (v2 favors early errors over runtime surprises).",{"start":1152,"end":1153},{"line":1056,"column":1147,"offset":1148},{"line":1056,"column":113,"offset":1154},2700,{"start":1156,"end":1158},{"line":1056,"column":23,"offset":1157},2574,{"line":1056,"column":113,"offset":1154},{"type":19,"value":81},{"type":14,"tagName":739,"properties":1161,"children":1162,"position":1171},{},[1163],{"type":19,"value":1164,"position":1165},"Validate indicators on historical and live data where behavior may depend on timing or data subscriptions.",{"start":1166,"end":1168},{"line":923,"column":129,"offset":1167},2704,{"line":923,"column":1169,"offset":1170},110,2810,{"start":1172,"end":1174},{"line":923,"column":23,"offset":1173},2701,{"line":923,"column":1169,"offset":1170},{"type":19,"value":81},{"start":1177,"end":1178},{"line":1039,"column":23,"offset":1086},{"line":923,"column":1169,"offset":1170},{"type":19,"value":81},{"type":14,"tagName":1181,"properties":1182,"children":1184},"hint",{"type":1183},"info",[1185],{"type":14,"tagName":15,"properties":1186,"children":1187,"position":1274},{},[1188,1203,1209,1223,1229,1243,1250,1267],{"type":14,"tagName":29,"properties":1189,"children":1190,"position":1198},{},[1191],{"type":19,"value":1192,"position":1193},"Docs vs platform:",{"start":1194,"end":1196},{"line":40,"column":89,"offset":1195},2840,{"line":40,"column":780,"offset":1197},2857,{"start":1199,"end":1201},{"line":40,"column":23,"offset":1200},2838,{"line":40,"column":92,"offset":1202},2859,{"type":19,"value":1204,"position":1205}," Published dates reflect when changes reached the documentation snapshot; your organization’s rollout timing may trail or lead ",{"start":1206,"end":1207},{"line":40,"column":92,"offset":1202},{"line":40,"column":61,"offset":1208},2986,{"type":14,"tagName":29,"properties":1210,"children":1211,"position":1219},{},[1212],{"type":19,"value":211,"position":1213},{"start":1214,"end":1216},{"line":40,"column":864,"offset":1215},2988,{"line":40,"column":1217,"offset":1218},164,3001,{"start":1220,"end":1221},{"line":40,"column":61,"offset":1208},{"line":40,"column":63,"offset":1222},3003,{"type":19,"value":1224,"position":1225}," slightly. Treat ",{"start":1226,"end":1227},{"line":40,"column":63,"offset":1222},{"line":40,"column":473,"offset":1228},3020,{"type":14,"tagName":29,"properties":1230,"children":1231,"position":1238},{},[1232],{"type":19,"value":211,"position":1233},{"start":1234,"end":1236},{"line":40,"column":377,"offset":1235},3022,{"line":40,"column":651,"offset":1237},3035,{"start":1239,"end":1240},{"line":40,"column":473,"offset":1228},{"line":40,"column":1241,"offset":1242},200,3037,{"type":19,"value":1244,"position":1245}," as the authoritative ",{"start":1246,"end":1247},{"line":40,"column":1241,"offset":1242},{"line":40,"column":1248,"offset":1249},222,3059,{"type":14,"tagName":1251,"properties":1252,"children":1253,"position":1263},"em",{},[1254],{"type":19,"value":1255,"position":1256},"behavior",{"start":1257,"end":1260},{"line":40,"column":1258,"offset":1259},223,3060,{"line":40,"column":1261,"offset":1262},231,3068,{"start":1264,"end":1265},{"line":40,"column":1248,"offset":1249},{"line":40,"column":101,"offset":1266},3069,{"type":19,"value":1268,"position":1269}," list for a given version tag.",{"start":1270,"end":1271},{"line":40,"column":101,"offset":1266},{"line":40,"column":1272,"offset":1273},262,3099,{"start":1275,"end":1276},{"line":40,"column":23,"offset":1200},{"line":40,"column":1272,"offset":1273},{"quirksMode":1278},false,{"start":1280,"end":1281},{"line":23,"column":23,"offset":24},{"line":1282,"column":23,"offset":1283},41,3116,1784888064232]