toshiki-notebook/assets/application_vitepress-plugin-shiki-twoslash_api_annotations.md.c19946d2.lean.js

import{_ as r,c as o,z as s,E as e,B as p,a,R as n,G as c,o as t}from"./chunks/framework.ade46834.js";const Fn=JSON.parse('{"title":"Meta Annotations","description":"Annotations provide a way to provide outside commentary on your code.","frontmatter":{"description":"Annotations provide a way to provide outside commentary on your code.","title":"Meta Annotations"},"headers":[],"relativePath":"application/vitepress-plugin-shiki-twoslash/api/annotations.md","filePath":"application/vitepress-plugin-shiki-twoslash/api/annotations.md","lastUpdated":1694919254000}'),i={name:"application/vitepress-plugin-shiki-twoslash/api/annotations.md"},d=s("h1",{id:"queries",tabindex:"-1"},[a("Queries "),s("a",{class:"header-anchor",href:"#queries","aria-label":'Permalink to "Queries"'},"​")],-1),_=s("p",null,"Sometimes the thing you want to say is about the code, annotations provide a way to provide outside commentary on your code.",-1),y=s("h2",{id:"annotate-left-right-overrides-text",tabindex:"-1"},[s("code",null,"@annotate: [left|right] [overrides] - [text]"),a(),s("a",{class:"header-anchor",href:"#annotate-left-right-overrides-text","aria-label":'Permalink to "`@annotate: [left|right] [overrides] - [text]`"'},"​")],-1),h=s("p",null,"Annotate has a lot more controls than most of the other Twoslash commands, because each use of it probably needs to feel a bit different. Here's an example based on the TypeScript home page, click it to get it running so we can talk about what it does:",-1),u={class:"vp-code-group vp-adaptive-theme"},m=n("",1),g={class:"blocks"},B={class:"language-ts vp-adaptive-theme active line-numbers-mode"},v=s("button",{title:"Copy Code",class:"copy"},null,-1),b=s("span",{class:"lang"},"ts",-1),f={class:"language-ts"},D={class:"tag-container"},T={class:"shiki solarized-dark twoslash lsp",style:{"background-color":"#002B36",color:"#839496"},active:"true"},w=s("div",{class:"language-id"},"ts",-1),A={class:"code-container"},q=s("div",{class:"line"},[s("span",{style:{color:"#93A1A1"}},"function"),s("span",{style:{color:"#839496"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"function compact(arr: any): any"},"compact")]),s("span",{style:{color:"#839496"}},[a("("),s("data-lsp",{lsp:"(parameter) arr: any"},"arr"),a(") {")])],-1),x={class:"line"},C=s("span",{style:{color:"#839496"}},"    ",-1),k=s("span",{style:{color:"#859900"}},"if",-1),S=s("span",{style:{color:"#839496"}}," (",-1),P={style:{color:"#268BD2"}},I=s("data-lsp",{lsp:"any"},"orr",-1),V=s("span",{style:{color:"#839496"}},[a("."),s("data-lsp",{lsp:"any"},"length"),a()],-1),E=n("",6),R=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")],-1),N=s("span",{style:{color:"#839496"}},".",-1),z=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"any"},"trim")],-1),M=n("",5),L=s("span",{class:"error"},[s("span",null,"Cannot find name 'orr'."),s("span",{class:"code"},"2304")],-1),Y=s("span",{class:"error-behind"},"Cannot find name 'orr'.",-1),F=s("div",{class:"line"},[s("span",{style:{color:"#839496"}},"    "),s("span",{style:{color:"#859900"}},"return"),s("span",{style:{color:"#839496"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")])],-1),Q=s("div",{class:"line"},[s("span",{style:{color:"#839496"}},"}")],-1),X={class:"twoslash-annotation left",style:{top:"0rem"}},$={style:{transform:"translateX(8px) translateY(27px) rotate(90deg)"},width:"40",height:"40",viewBox:"0 0 40 40",fill:"none",xmlns:"http://www.w3.org/2000/svg"},j=s("path",{d:"M1 39C1.5 32.7511 6.1 17.5173 20.5 6.57333M11.5 4.04L27 0.999998C24.8333 4.88444 20.5 13.16 20.5 15.1867",stroke:"black"},null,-1),O=s("p",{class:"twoslash-annotation-text",style:{transform:"rotate(3deg)"}},"Discovered a typo, the param is arr, not orr!",-1),W={class:"tag-container"},H={class:"shiki solarized-light twoslash lsp",style:{"background-color":"#FDF6E3",color:"#657B83"},active:"true"},J=s("div",{class:"language-id"},"ts",-1),K={class:"code-container"},U=s("div",{class:"line"},[s("span",{style:{color:"#586E75"}},"function"),s("span",{style:{color:"#657B83"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"function compact(arr: any): any"},"compact")]),s("span",{style:{color:"#657B83"}},[a("("),s("data-lsp",{lsp:"(parameter) arr: any"},"arr"),a(") {")])],-1),Z={class:"line"},G=s("span",{style:{color:"#657B83"}},"    ",-1),ss=s("span",{style:{color:"#859900"}},"if",-1),as=s("span",{style:{color:"#657B83"}}," (",-1),ns={style:{color:"#268BD2"}},os=s("data-lsp",{lsp:"any"},"orr",-1),ts=s("span",{style:{color:"#657B83"}},[a("."),s("data-lsp",{lsp:"any"},"length"),a()],-1),ls=n("",6),es=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")],-1),ps=s("span",{style:{color:"#657B83"}},".",-1),rs=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"any"},"trim")],-1),cs=n("",5),is=s("span",{class:"error"},[s("span",null,"Cannot find name 'orr'."),s("span",{class:"code"},"2304")],-1),ds=s("span",{class:"error-behind"},"Cannot find name 'orr'.",-1),_s=s("div",{class:"line"},[s("span",{style:{color:"#657B83"}},"    "),s("span",{style:{color:"#859900"}},"return"),s("span",{style:{color:"#657B83"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")])],-1),ys=s("div",{class:"line"},[s("span",{style:{color:"#657B83"}},"}")],-1),hs={class:"twoslash-annotation left",style:{top:"0rem"}},us={style:{transform:"translateX(8px) translateY(27px) rotate(90deg)"},width:"40",height:"40",viewBox:"0 0 40 40",fill:"none",xmlns:"http://www.w3.org/2000/svg"},ms=s("path",{d:"M1 39C1.5 32.7511 6.1 17.5173 20.5 6.57333M11.5 4.04L27 0.999998C24.8333 4.88444 20.5 13.16 20.5 15.1867",stroke:"black"},null,-1),gs=s("p",{class:"twoslash-annotation-text",style:{transform:"rotate(3deg)"}},"Discovered a typo, the param is arr, not orr!",-1),Bs=s("div",{class:"line-numbers-wrapper","aria-hidden":"true"},[s("span",{class:"line-number"},"1"),s("br")],-1),vs=n("",1),bs=n("",4),fs={class:"vp-code-group vp-adaptive-theme"},Ds=n("",1),Ts={class:"blocks"},ws={class:"language-ts vp-adaptive-theme active line-numbers-mode"},As=s("button",{title:"Copy Code",class:"copy"},null,-1),qs=s("span",{class:"lang"},"ts",-1),xs={class:"language-ts"},Cs={class:"tag-container"},ks={class:"shiki solarized-dark twoslash lsp",style:{"background-color":"#002B36",color:"#839496"},active:"true"},Ss=s("div",{class:"language-id"},"ts",-1),Ps={class:"code-container"},Is=s("div",{class:"line"},[s("span",{style:{color:"#93A1A1"}},"function"),s("span",{style:{color:"#839496"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"function compact(arr: any): any"},"compact")]),s("span",{style:{color:"#839496"}},[a("("),s("data-lsp",{lsp:"(parameter) arr: any"},"arr"),a(") {")])],-1),Vs={class:"line"},Es=s("span",{style:{color:"#839496"}},"    ",-1),Rs=s("span",{style:{color:"#859900"}},"if",-1),Ns=s("span",{style:{color:"#839496"}}," (",-1),zs={style:{color:"#268BD2"}},Ms=s("data-lsp",{lsp:"any"},"orr",-1),Ls=s("span",{style:{color:"#839496"}},[a("."),s("data-lsp",{lsp:"any"},"length"),a()],-1),Ys=n("",6),Fs=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")],-1),Qs=s("span",{style:{color:"#839496"}},".",-1),Xs=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"any"},"trim")],-1),$s=n("",5),js=s("span",{class:"error"},[s("span",null,"Cannot find name 'orr'."),s("span",{class:"code"},"2304")],-1),Os=s("span",{class:"error-behind"},"Cannot find name 'orr'.",-1),Ws=s("div",{class:"line"},[s("span",{style:{color:"#839496"}},"    "),s("span",{style:{color:"#859900"}},"return"),s("span",{style:{color:"#839496"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")])],-1),Hs=s("div",{class:"line"},[s("span",{style:{color:"#839496"}},"}")],-1),Js={class:"twoslash-annotation right",style:{top:"3rem"}},Ks={style:{transform:"translateX(-10px) translateY(-10px) rotate(-50deg)"},width:"40",height:"40",viewBox:"0 0 40 40",fill:"none",xmlns:"http://www.w3.org/2000/svg"},Us=s("path",{d:"M27 39C26.5 32.7511 21.9 17.5173 7.5 6.57333M16.5 4.04L0.999999 0.999998C3.16667 4.88444 7.5 13.16 7.5 15.1867",stroke:"black"},null,-1),Zs=s("p",{class:"twoslash-annotation-text",style:{transform:"rotate(0deg)"}},"Discovered a typo, the param is arr, not orr!",-1),Gs={class:"tag-container"},sa={class:"shiki solarized-light twoslash lsp",style:{"background-color":"#FDF6E3",color:"#657B83"},active:"true"},aa=s("div",{class:"language-id"},"ts",-1),na={class:"code-container"},oa=s("div",{class:"line"},[s("span",{style:{color:"#586E75"}},"function"),s("span",{style:{color:"#657B83"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"function compact(arr: any): any"},"compact")]),s("span",{style:{color:"#657B83"}},[a("("),s("data-lsp",{lsp:"(parameter) arr: any"},"arr"),a(") {")])],-1),ta={class:"line"},la=s("span",{style:{color:"#657B83"}},"    ",-1),ea=s("span",{style:{color:"#859900"}},"if",-1),pa=s("span",{style:{color:"#657B83"}}," (",-1),ra={style:{color:"#268BD2"}},ca=s("data-lsp",{lsp:"any"},"orr",-1),ia=s("span",{style:{color:"#657B83"}},[a("."),s("data-lsp",{lsp:"any"},"length"),a()],-1),da=n("",6),_a=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")],-1),ya=s("span",{style:{color:"#657B83"}},".",-1),ha=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"any"},"trim")],-1),ua=n("",5),ma=s("span",{class:"error"},[s("span",null,"Cannot find name 'orr'."),s("span",{class:"code"},"2304")],-1),ga=s("span",{class:"error-behind"},"Cannot find name 'orr'.",-1),Ba=s("div",{class:"line"},[s("span",{style:{color:"#657B83"}},"    "),s("span",{style:{color:"#859900"}},"return"),s("span",{style:{color:"#657B83"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")])],-1),va=s("div",{class:"line"},[s("span",{style:{color:"#657B83"}},"}")],-1),ba={class:"twoslash-annotation right",style:{top:"3rem"}},fa={style:{transform:"translateX(-10px) translateY(-10px) rotate(-50deg)"},width:"40",height:"40",viewBox:"0 0 40 40",fill:"none",xmlns:"http://www.w3.org/2000/svg"},Da=s("path",{d:"M27 39C26.5 32.7511 21.9 17.5173 7.5 6.57333M16.5 4.04L0.999999 0.999998C3.16667 4.88444 7.5 13.16 7.5 15.1867",stroke:"black"},null,-1),Ta=s("p",{class:"twoslash-annotation-text",style:{transform:"rotate(0deg)"}},"Discovered a typo, the param is arr, not orr!",-1),wa=s("div",{class:"line-numbers-wrapper","aria-hidden":"true"},[s("span",{class:"line-number"},"1"),s("br")],-1),Aa=n("",1),qa=s("p",null,"Upside down arrow pointing at the error, using flipped to re-flip the arrow:",-1),xa={class:"vp-code-group vp-adaptive-theme"},Ca=n("",1),ka={class:"blocks"},Sa={class:"language-ts vp-adaptive-theme active line-numbers-mode"},Pa=s("button",{title:"Copy Code",class:"copy"},null,-1),Ia=s("span",{class:"lang"},"ts",-1),Va={class:"language-ts"},Ea={class:"tag-container"},Ra={class:"shiki solarized-dark twoslash lsp",style:{"background-color":"#002B36",color:"#839496"},active:"true"},Na=s("div",{class:"language-id"},"ts",-1),za={class:"code-container"},Ma=s("div",{class:"line"},[s("span",{style:{color:"#93A1A1"}},"function"),s("span",{style:{color:"#839496"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"function compact(arr: any): any"},"compact")]),s("span",{style:{color:"#839496"}},[a("("),s("data-lsp",{lsp:"(parameter) arr: any"},"arr"),a(") {")])],-1),La={class:"line"},Ya=s("span",{style:{color:"#839496"}},"    ",-1),Fa=s("span",{style:{color:"#859900"}},"if",-1),Qa=s("span",{style:{color:"#839496"}}," (",-1),Xa={style:{color:"#268BD2"}},$a=s("data-lsp",{lsp:"any"},"orr",-1),ja=s("span",{style:{color:"#839496"}},[a("."),s("data-lsp",{lsp:"any"},"length"),a()],-1),Oa=n("",6),Wa=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")],-1),Ha=s("span",{style:{color:"#839496"}},".",-1),Ja=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"any"},"trim")],-1),Ka=n("",5),Ua=s("span",{class:"error"},[s("span",null,"Cannot find name 'orr'."),s("span",{class:"code"},"2304")],-1),Za=s("span",{class:"error-behind"},"Cannot find name 'orr'.",-1),Ga=s("div",{class:"line"},[s("span",{style:{color:"#839496"}},"    "),s("span",{style:{color:"#859900"}},"return"),s("span",{style:{color:"#839496"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")])],-1),sn=s("div",{class:"line"},[s("span",{style:{color:"#839496"}},"}")],-1),an={class:"twoslash-annotation right",style:{top:"-0.7rem"}},nn={style:{transform:"translateX(8px) translateY(46px) rotate(190deg)"},width:"40",height:"40",viewBox:"0 0 40 40",fill:"none",xmlns:"http://www.w3.org/2000/svg"},on=s("path",{d:"M1 39C1.5 32.7511 6.1 17.5173 20.5 6.57333M11.5 4.04L27 0.999998C24.8333 4.88444 20.5 13.16 20.5 15.1867",stroke:"black"},null,-1),tn=s("p",{class:"twoslash-annotation-text",style:{transform:"rotate(-3deg)"}},"Discovered a typo, the param is arr, not orr!",-1),ln={class:"tag-container"},en={class:"shiki solarized-light twoslash lsp",style:{"background-color":"#FDF6E3",color:"#657B83"},active:"true"},pn=s("div",{class:"language-id"},"ts",-1),rn={class:"code-container"},cn=s("div",{class:"line"},[s("span",{style:{color:"#586E75"}},"function"),s("span",{style:{color:"#657B83"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"function compact(arr: any): any"},"compact")]),s("span",{style:{color:"#657B83"}},[a("("),s("data-lsp",{lsp:"(parameter) arr: any"},"arr"),a(") {")])],-1),dn={class:"line"},_n=s("span",{style:{color:"#657B83"}},"    ",-1),yn=s("span",{style:{color:"#859900"}},"if",-1),hn=s("span",{style:{color:"#657B83"}}," (",-1),un={style:{color:"#268BD2"}},mn=s("data-lsp",{lsp:"any"},"orr",-1),gn=s("span",{style:{color:"#657B83"}},[a("."),s("data-lsp",{lsp:"any"},"length"),a()],-1),Bn=n("",6),vn=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")],-1),bn=s("span",{style:{color:"#657B83"}},".",-1),fn=s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"any"},"trim")],-1),Dn=n("",5),Tn=s("span",{class:"error"},[s("span",null,"Cannot find name 'orr'."),s("span",{class:"code"},"2304")],-1),wn=s("span",{class:"error-behind"},"Cannot find name 'orr'.",-1),An=s("div",{class:"line"},[s("span",{style:{color:"#657B83"}},"    "),s("span",{style:{color:"#859900"}},"return"),s("span",{style:{color:"#657B83"}}," "),s("span",{style:{color:"#268BD2"}},[s("data-lsp",{lsp:"(parameter) arr: any"},"arr")])],-1),qn=s("div",{class:"line"},[s("span",{style:{color:"#657B83"}},"}")],-1),xn={class:"twoslash-annotation right",style:{top:"-0.7rem"}},Cn={style:{transform:"translateX(8px) translateY(46px) rotate(190deg)"},width:"40",height:"40",viewBox:"0 0 40 40",fill:"none",xmlns:"http://www.w3.org/2000/svg"},kn=s("path",{d:"M1 39C1.5 32.7511 6.1 17.5173 20.5 6.57333M11.5 4.04L27 0.999998C24.8333 4.88444 20.5 13.16 20.5 15.1867",stroke:"black"},null,-1),Sn=s("p",{class:"twoslash-annotation-text",style:{transform:"rotate(-3deg)"}},"Discovered a typo, the param is arr, not orr!",-1),Pn=s("div",{class:"line-numbers-wrapper","aria-hidden":"true"},[s("span",{class:"line-number"},"1"),s("br")],-1),In=n("",1);function Vn(En,Rn,Nn,zn,Mn,Ln){const l=c("data-err");return t(),o("div",null,[d,_,y,h,s("div",u,[m,s("div",g,[s("div",B,[v,b,s("pre",null,[s("code",f,[s("div",D,[s("pre",T,[w,s("div",A,[s("code",null,[q,s("div",x,[C,k,S,s("span",P,[e(l,null,{default:p(()=>[I]),_:1})]),V,E,R,N,z,M]),L,Y,F,Q])])]),a(`
`),s("div",X,[a(`
  `),(t(),o("svg",$,[a(`
    `),j,a(`
`)])),a(`
  `),O,a(`
`)])]),a(`
`),s("div",W,[s("pre",H,[J,s("div",K,[s("code",null,[U,s("div",Z,[G,ss,as,s("span",ns,[e(l,null,{default:p(()=>[os]),_:1})]),ts,ls,es,ps,rs,cs]),is,ds,_s,ys])])]),a(`
`),s("div",hs,[a(`
  `),(t(),o("svg",us,[a(`
    `),ms,a(`
`)])),a(`
  `),gs,a(`
`)])])])]),Bs]),vs])]),bs,s("div",fs,[Ds,s("div",Ts,[s("div",ws,[As,qs,s("pre",null,[s("code",xs,[s("div",Cs,[s("pre",ks,[Ss,s("div",Ps,[s("code",null,[Is,s("div",Vs,[Es,Rs,Ns,s("span",zs,[e(l,null,{default:p(()=>[Ms]),_:1})]),Ls,Ys,Fs,Qs,Xs,$s]),js,Os,Ws,Hs])])]),a(`
`),s("div",Js,[a(`
  `),(t(),o("svg",Ks,[a(`
    `),Us,a(`
`)])),a(`
  `),Zs,a(`
`)])]),a(`
`),s("div",Gs,[s("pre",sa,[aa,s("div",na,[s("code",null,[oa,s("div",ta,[la,ea,pa,s("span",ra,[e(l,null,{default:p(()=>[ca]),_:1})]),ia,da,_a,ya,ha,ua]),ma,ga,Ba,va])])]),a(`
`),s("div",ba,[a(`
  `),(t(),o("svg",fa,[a(`
    `),Da,a(`
`)])),a(`
  `),Ta,a(`
`)])])])]),wa]),Aa])]),qa,s("div",xa,[Ca,s("div",ka,[s("div",Sa,[Pa,Ia,s("pre",null,[s("code",Va,[s("div",Ea,[s("pre",Ra,[Na,s("div",za,[s("code",null,[Ma,s("div",La,[Ya,Fa,Qa,s("span",Xa,[e(l,null,{default:p(()=>[$a]),_:1})]),ja,Oa,Wa,Ha,Ja,Ka]),Ua,Za,Ga,sn])])]),a(`
`),s("div",an,[a(`
  `),(t(),o("svg",nn,[a(`
    `),on,a(`
`)])),a(`
  `),tn,a(`
`)])]),a(`
`),s("div",ln,[s("pre",en,[pn,s("div",rn,[s("code",null,[cn,s("div",dn,[_n,yn,hn,s("span",un,[e(l,null,{default:p(()=>[mn]),_:1})]),gn,Bn,vn,bn,fn,Dn]),Tn,wn,An,qn])])]),a(`
`),s("div",xn,[a(`
  `),(t(),o("svg",Cn,[a(`
    `),kn,a(`
`)])),a(`
  `),Sn,a(`
`)])])])]),Pn]),In])])])}const Qn=r(i,[["render",Vn]]);export{Fn as __pageData,Qn as default};