Csound.sublime-syntax

%YAML 1.2
---
name: Csound
file_extensions: [csd]
scope: source.csound

variables:
  pyrun:         '\b(pyl?run)(i|t)?\b'      # embed python code
  pyrun_trigger: '\b(g)?(k)[A-Za-z0-9_]+\b' # with optional trigger

  # opcodes
  opcode:       '\b(ATSadd|ATSaddnz|ATSbufread|ATScross|ATSinfo|ATSinterpread|ATSpartialtap|ATSread|ATSreadnz|ATSsinnoi|FLbox|FLbutBank|FLbutton|FLcloseButton|FLcolor|FLcolor2|FLcount|FLexecButton|FLgetsnap|FLgroup|FLgroupEnd|FLgroup_end|FLhide|FLhvsBox|FLhvsBoxSetValue|FLjoy|FLkeyIn|FLknob|FLlabel|FLloadsnap|FLmouse|FLpack|FLpackEnd|FLpack_end|FLpanel|FLpanelEnd|FLpanel_end|FLprintk|FLprintk2|FLroller|FLrun|FLsavesnap|FLscroll|FLscrollEnd|FLscroll_end|FLsetAlign|FLsetBox|FLsetColor|FLsetColor2|FLsetFont|FLsetPosition|FLsetSize|FLsetSnapGroup|FLsetText|FLsetTextColor|FLsetTextSize|FLsetTextType|FLsetVal|FLsetVal_i|FLsetsnap|FLshow|FLslidBnk|FLslidBnk2|FLslidBnk2Set|FLslidBnk2Setk|FLslidBnkGetHandle|FLslidBnkSet|FLslidBnkSetk|FLslider|FLtabs|FLtabsEnd|FLtabs_end|FLtext|FLupdate|FLvalue|FLvkeybd|FLvslidBnk|FLvslidBnk2|FLxyin|JackoAudioIn|JackoAudioInConnect|JackoAudioOut|JackoAudioOutConnect|JackoFreewheel|JackoInfo|JackoInit|JackoMidiInConnect|JackoMidiOut|JackoMidiOutConnect|JackoNoteOut|JackoOn|JackoTransport|MixerClear|MixerGetLevel|MixerReceive|MixerSend|MixerSetLevel|MixerSetLevel_i|STKBandedWG|STKBeeThree|STKBlowBotl|STKBlowHole|STKBowed|STKBrass|STKClarinet|STKDrummer|STKFMVoices|STKFlute|STKHevyMetl|STKMandolin|STKModalBar|STKMoog|STKPercFlut|STKPlucked|STKResonate|STKRhodey|STKSaxofony|STKShakers|STKSimple|STKSitar|STKStifKarp|STKTubeBell|STKVoicForm|STKWhistle|STKWurley|a|abetarand|abexprnd|abs|acauchy|active|adsr|adsyn|adsynt|adsynt2|aexprand|aftouch|agauss|agogobel|alinrand|alpass|alwayson|ampdb|ampdbfs|ampmidi|ampmidid|apcauchy|apoisson|apow|areson|aresonk|array|atone|atonek|atonex|atrirand|aunirand|aweibull|babo|balance|bamboo|barmodel|bbcutm|bbcuts|betarand|bexprnd|bformdec|bformdec1|bformenc|bformenc1|binit|biquad|biquada|birnd|bqrez|buchla|butbp|butbr|buthp|butlp|butterbp|butterbr|butterhp|butterlp|button|buzz|c2r|cabasa|cauchy|cauchyi|ceil|cell|cent|centroid|ceps|chanctrl|changed|chebyshevpoly|checkbox|chuap|clear|clfilt|clip|clock|clockoff|clockon|cmplxprod|comb|combinv|compilecsd|compileorc|compilestr|compress|connect|control|convle|convolve|copy2ftab|copy2ttab|copya2ftab|copyf2array|cos|cosh|cosinv|cosseg|cossegb|cossegr|cps2pch|cpsmidi|cpsmidib|cpsmidinn|cpsoct|cpspch|cpstmid|cpstun|cpstuni|cpsxpch|cpumeter|cpuprc|cross2|crossfm|crossfmi|crossfmpm|crossfmpmi|crosspm|crosspmi|crunch|ctlchn|ctrl14|ctrl21|ctrl7|ctrlinit|cuserrnd|dam|date|dates|db|dbamp|dbfsamp|dcblock|dcblock2|dconv|delay|delay1|delayk|delayr|delayw|deltap|deltap3|deltapi|deltapn|deltapx|deltapxw|denorm|diff|diskgrain|diskin|diskin2|dispfft|display|distort|distort1|divz|doppler|downsamp|dripwater|dssiactivate|dssiaudio|dssictls|dssiinit|dssilist|dumpk|dumpk2|dumpk3|dumpk4|duserrnd|dust|dust2|envlpx|envlpxr|ephasor|eqfil|evalstr|event|event_i|exciter|exitnow|exp|expcurve|expon|exprand|exprandi|expseg|expsega|expsegb|expsegba|expsegr|fareylen|fareyleni|faustaudio|faustcompile|faustctl|faustgen|fft|fftinv|ficlose|filebit|filelen|filenchnls|filepeak|filesr|filevalid|fillarray|filter2|fin|fini|fink|fiopen|flanger|flashtxt|flooper|flooper2|floor|fluidAllOut|fluidCCi|fluidCCk|fluidControl|fluidEngine|fluidLoad|fluidNote|fluidOut|fluidProgramSelect|fluidSetInterpMethod|fmb3|fmbell|fmmetal|fmpercfl|fmrhode|fmvoice|fmwurlie|fof|fof2|fofilter|fog|fold|follow|follow2|foscil|foscili|fout|fouti|foutir|foutk|fprintks|fprints|frac|fractalnoise|framebuffer|freeverb|ftchnls|ftconv|ftcps|ftfree|ftgen|ftgenonce|ftgentmp|ftlen|ftload|ftloadk|ftlptim|ftmorf|ftresize|ftresizei|ftsave|ftsavek|ftsr|gain|gainslider|gauss|gaussi|gausstrig|gbuzz|genarray|genarray_i|gendy|gendyc|gendyx|getcfg|getcol|getrow|getseed|gogobel|grain|grain2|grain3|granule|guiro|harmon|harmon2|harmon3|harmon4|hdf5read|hdf5write|hilbert|hrtfearly|hrtfer|hrtfmove|hrtfmove2|hrtfreverb|hrtfstat|hsboscil|hvs1|hvs2|hvs3|i|ibetarand|ibexprnd|icauchy|iceps|ictrl14|ictrl21|ictrl7|iexprand|igauss|ihold|ilinrand|imagecreate|imagefree|imagegetpixel|imageload|imagesave|imagesetpixel|imagesize|imidic14|imidic21|imidic7|in|in32|inch|inh|init|initc14|initc21|initc7|inleta|inletf|inletk|inletkid|inletv|ino|inq|inrg|ins|insglobal|insremot|instimek|instimes|int|integ|interp|inx|inz|ioff|ion|iondur|iondur2|ioutat|ioutc|ioutc14|ioutpat|ioutpb|ioutpc|ipcauchy|ipoisson|ipow|is16b14|is32b14|islider16|islider32|islider64|islider8|itablecopy|itablegpw|itablemix|itablew|itrirand|iunirand|iweibull|jacktransport|jitter|jitter2|jspline|k|kbetarand|kbexprnd|kcauchy|kdump|kdump2|kdump3|kdump4|kexprand|kfilter2|kgauss|klinrand|kon|koutat|koutc|koutc14|koutpat|koutpb|koutpc|kpcauchy|kpoisson|kpow|kr|kread|kread2|kread3|kread4|ksmps|ktableseg|ktrirand|kunirand|kweibull|lenarray|lentab|lfo|limit|line|linen|linenr|lineto|linrand|linseg|linsegb|linsegr|locsend|locsig|log|log10|log2|logbtwo|logcurve|loopseg|loopsegp|looptseg|loopxseg|lorenz|lorismorph|lorisplay|lorisread|loscil|loscil3|loscilx|lowpass2|lowres|lowresx|lpf18|lpform|lpfreson|lphasor|lpinterp|lposcil|lposcil3|lposcila|lposcilsa|lposcilsa2|lpread|lpreson|lpshold|lpsholdp|lpslot|lua_exec|lua_opcall|lua_opdef|mac|maca|madsr|mags|mandel|mandol|maparray|maparray_i|marimba|massign|max|max_k|maxabs|maxabsaccum|maxaccum|maxalloc|maxarray|maxtab|mclock|mdelay|median|mediank|metro|midglobal|midic14|midic21|midic7|midichannelaftertouch|midichn|midicontrolchange|midictrl|mididefault|midifilestatus|midiin|midinoteoff|midinoteoncps|midinoteonkey|midinoteonoct|midinoteonpch|midion|midion2|midiout|midipgm|midipitchbend|midipolyaftertouch|midiprogramchange|miditempo|midremot|min|minabs|minabsaccum|minaccum|minarray|mincer|mintab|mirror|mode|modmatrix|monitor|moog|moogladder|moogvcf|moogvcf2|moscil|mp3bitrate|mp3in|mp3len|mp3nchnls|mp3sr|mpulse|mrtmsg|multitap|multtab|mute|mxadsr|nchnls|nchnls_i|nestedap|nlalp|nlfilt|nlfilt2|noise|noteoff|noteon|noteondur|noteondur2|notnum|nreverb|nrpn|nsamp|nstance|nstrnum|ntrpol|octave|octcps|octmidi|octmidib|octmidinn|octpch|olabuffer|oscbnk|oscil|oscil1|oscil1i|oscil3|oscili|oscilikt|osciliktp|oscilikts|osciln|oscils|oscilx|out|out32|outc|outch|outh|outiat|outic|outic14|outipat|outipb|outipc|outkat|outkc|outkc14|outkpat|outkpb|outkpc|outleta|outletf|outletk|outletkid|outletv|outo|outq|outq1|outq2|outq3|outq4|outrg|outs|outs1|outs2|outx|outz|p|p5gconnect|p5gdata|pan|pan2|pareq|part2txt|partials|partikkel|partikkelget|partikkelset|partikkelsync|passign|pcauchy|pchbend|pchmidi|pchmidib|pchmidinn|pchoct|pconvolve|pcount|pdclip|pdhalf|pdhalfy|peak|peakk|pgmassign|pgmchn|phaser1|phaser2|phasor|phasorbnk|phs|pindex|pinker|pinkish|pitch|pitchac|pitchamdf|planet|platerev|plltrack|pluck|plustab|plyexect|poisson|pol2rect|polyaft|polynomial|pop|pop_f|port|portk|poscil|poscil3|pow|powershape|powoftwo|prealloc|prepiano|print|print_type|printf|printf_i|printk|printk2|printks|printks2|prints|product|pset|ptable|ptable3|ptablei|ptableiw|ptablew|ptrack|push|push_f|puts|pvadd|pvbufread|pvcross|pvinterp|pvoc|pvread|pvs2array|pvs2tab|pvsadsyn|pvsanal|pvsarp|pvsbandp|pvsbandr|pvsbin|pvsblur|pvsbuffer|pvsbufread|pvsbufread2|pvscale|pvscent|pvsceps|pvscross|pvsdemix|pvsdiskin|pvsdisp|pvsenvftw|pvsfilter|pvsfread|pvsfreeze|pvsfromarray|pvsftr|pvsftw|pvsfwrite|pvsgain|pvsgendy|pvshift|pvsifd|pvsin|pvsinfo|pvsinit|pvslock|pvsmaska|pvsmix|pvsmooth|pvsmorph|pvsosc|pvsout|pvspitch|pvstanal|pvstencil|pvsvoc|pvswarp|pvsynth|pwd|pyassign|pyassigni|pyassignt|pycall|pycall1|pycall1i|pycall1t|pycall2|pycall2i|pycall2t|pycall3|pycall3i|pycall3t|pycall4|pycall4i|pycall4t|pycall5|pycall5i|pycall5t|pycall6|pycall6i|pycall6t|pycall7|pycall7i|pycall7t|pycall8|pycall8i|pycall8t|pycalli|pycalln|pycallni|pycallt|pyeval|pyevali|pyevalt|pyexec|pyexeci|pyexect|pyinit|pylassign|pylassigni|pylassignt|pylcall|pylcall1|pylcall1i|pylcall1t|pylcall2|pylcall2i|pylcall2t|pylcall3|pylcall3i|pylcall3t|pylcall4|pylcall4i|pylcall4t|pylcall5|pylcall5i|pylcall5t|pylcall6|pylcall6i|pylcall6t|pylcall7|pylcall7i|pylcall7t|pylcall8|pylcall8i|pylcall8t|pylcalli|pylcalln|pylcallni|pylcallt|pyleval|pylevali|pylevalt|pylexec|pylexeci|pylexect|pylrun|pylruni|pylrunt|pyrun|pyruni|pyrunt|qinf|qnan|r2c|rand|randh|randi|random|randomh|randomi|rbjeq|readclock|readf|readfi|readk|readk2|readk3|readk4|readks|readscore|readscratch|rect2pol|reinit|release|remoteport|remove|repluck|reson|resonk|resonr|resonx|resonxk|resony|resonz|resyn|return|reverb|reverb2|reverbsc|rewindscore|rezzy|rfft|rifft|rireturn|rms|rnd|rnd31|round|rspline|rtclock|s16b14|s32b14|samphold|sandpaper|scale|scalearray|scalet|scanhammer|scans|scantable|scanu|schedkwhen|schedkwhennamed|schedule|schedwhen|scoreline|scoreline_i|seed|sekere|semitone|sense|sensekey|seqtime|seqtime2|serialBegin|serialEnd|serialFlush|serialPrint|serialRead|serialWrite|serialWrite_i|setcol|setctrl|setksmps|setrow|setscorepos|sfilist|sfinstr|sfinstr3|sfinstr3m|sfinstrm|sfload|sflooper|sfpassign|sfplay|sfplay3|sfplay3m|sfplaym|sfplist|sfpreset|shaker|shiftin|shiftout|signalflowgraph|signum|sin|sinh|sininv|sinsyn|sleighbells|slicearray|slider16|slider16f|slider16table|slider16tablef|slider32|slider32f|slider32table|slider32tablef|slider64|slider64f|slider64table|slider64tablef|slider8|slider8f|slider8table|slider8tablef|sliderKawai|sndload|sndloop|sndwarp|sndwarpst|sockrecv|sockrecvs|socksend|socksends|soundin|soundout|soundouts|space|spat3d|spat3di|spat3dt|spdist|specaddm|specdiff|specdisp|specfilt|spechist|specptrk|specscal|specsum|spectrum|splitrig|sprintf|sprintfk|spsend|sqrt|sr|stack|statevar|stix|strcat|strcatk|strchar|strchark|strcmp|strcmpk|strcpy|strcpyk|strecv|streson|strfromurl|strget|strindex|strindexk|strlen|strlenk|strlower|strlowerk|strrindex|strrindexk|strset|strsub|strsubk|strtod|strtodk|strtol|strtolk|strupper|strupperk|stsend|subinstr|subinstrinit|sum|sumarray|sumtab|svfilter|syncgrain|syncloop|syncphasor|system|system_i|tab|tab2pvs|tab_i|tabgen|tabifd|table|table3|table3kt|tablecopy|tablefilter|tablefilteri|tablegpw|tablei|tableicopy|tableigpw|tableikt|tableimix|tableiw|tablekt|tablemix|tableng|tablera|tableseg|tableshuffle|tableshufflei|tablew|tablewa|tablewkt|tablexkt|tablexseg|tabmap|tabmap_i|tabmorph|tabmorpha|tabmorphak|tabmorphi|tabplay|tabrec|tabslice|tabsum|tabw|tabw_i|tambourine|tan|tanh|taninv|taninv2|tb|tb0|tb0_init|tb1|tb10|tb10_init|tb11|tb11_init|tb12|tb12_init|tb13|tb13_init|tb14|tb14_init|tb15|tb15_init|tb1_init|tb2|tb2_init|tb3|tb3_init|tb4|tb4_init|tb5|tb5_init|tb6|tb6_init|tb7|tb7_init|tb8|tb8_init|tb9|tb9_init|tbvcf|tempest|tempo|temposcal|tempoval|timedseq|timeinstk|timeinsts|timek|times|timout|tival|tlineto|tone|tonek|tonex|tradsyn|trandom|transeg|transegb|transegr|trcross|trfilter|trhighest|trigger|trigseq|trirand|trlowest|trmix|trscale|trshift|trsplit|turnoff|turnoff2|turnon|unirand|unwrap|upsamp|urandom|urd|vactrol|vadd|vadd_i|vaddv|vaddv_i|vaget|valpass|vaset|vbap|vbap16|vbap16move|vbap4|vbap4move|vbap8|vbap8move|vbapg|vbapgmove|vbaplsinit|vbapmove|vbapz|vbapzmove|vcella|vco|vco2|vco2ft|vco2ift|vco2init|vcomb|vcopy|vcopy_i|vdel_k|vdelay|vdelay3|vdelayk|vdelayx|vdelayxq|vdelayxs|vdelayxw|vdelayxwq|vdelayxws|vdivv|vdivv_i|vecdelay|veloc|vexp|vexp_i|vexpseg|vexpv|vexpv_i|vibes|vibr|vibrato|vincr|vlimit|vlinseg|vlowres|vmap|vmirror|vmult|vmult_i|vmultv|vmultv_i|voice|vosim|vphaseseg|vport|vpow|vpow_i|vpowv|vpowv_i|vpvoc|vrandh|vrandi|vstaudio|vstaudiog|vstbankload|vstedit|vstinfo|vstinit|vstmidiout|vstnote|vstparamget|vstparamset|vstprogset|vsubv|vsubv_i|vtaba|vtabi|vtabk|vtable1k|vtablea|vtablei|vtablek|vtablewa|vtablewi|vtablewk|vtabwa|vtabwi|vtabwk|vwrap|waveset|weibull|wgbow|wgbowedbar|wgbrass|wgclar|wgflute|wgpluck|wgpluck2|wguide1|wguide2|wiiconnect|wiidata|wiirange|wiisend|window|wrap|writescratch|wterrain|xadsr|xin|xout|xscanmap|xscans|xscansmap|xscanu|xtratim|xyin|zacl|zakinit|zamod|zar|zarg|zaw|zawm|zfilter2|zir|ziw|ziwm|zkcl|zkmod|zkr|zkw|zkwm|link_enable|link_create|link_peers|link_is_enabled|link_tempo_get|paulstretch|link_tempo_set)\b'
  udo:          'MyOpcode|AnotherOpcode'

  software_bus: '\b(chan(i|o)|chn_(k|a|S)|chn(clear|export|get|mix|params|set)|(in|out)value)\b'
  osc:          '\b(OSC(bundle|count|initM?|listen|raw|send))\b'

  conditional:  '\b(if|then|else|elseif|endif)\b'
  goto:         '\b((cg|ci|ck|cn|i|k|ri|ti)?goto)\b'
  loop:         '\b(loop_(ge|gt|le|lt)|until|while)\b'

  variable: '\b(g)?(i|k|a|f|S)[A-Za-z0-9_]+\b' # csound variable
  pfield:   '\bp[0-9]+\b'                      # score parameter
  
  arithmetic: '\s(\+|\-|\*|\/|\^|\%)\s'
  assignment: '\s(\=|\+\=|\-\=|\*\=|\/\=)\s'
  comparison: '\s(\<\=|\>\=|\<|\>|\=\=|\!\=)\s'
  logical:    '\s(\&\&|\|\||\!)\s'

  # printf
  decimal: '(%[0-9]{,3}(d|i|o|u))'
  hex:     '(%[abcdefABCDEF0-9]{,3}(x|X))'
  char:    '(%(c|s))'
  float:   '(%([0-9]{,3}\.)?[0-9]{,3}(f|F|e|E|g|G]))'

contexts:
  main:
    - match: '<CsOptions>'
      scope: entity.name.tag.csound
      push: options

    - match: '<CsInstruments>'
      scope: entity.name.tag.csound
      push: orchestra

    - match: '<CsScore>'
      scope: entity.name.tag.csound
      push: score

    - match: '<.+>' # any other section tag
      scope: entity.name.tag.csound

  options:
    - match: '(-(?:-|\+)?)[A-Za-z0-9_-]+(?:(\=)([^"].*\b)?)?'
      scope: variable.parameter.option.csound
      captures:
        1: punctuation.definition.parameter.csound # minus/plus ( - + )
        2: keyword.operator.assignment.csound      # equal sign ( = )
        3: string.unquoted.csound                  # unquoted argument
    - match: ':' # for arguments like adc/dac
      scope: punctuation.separator.argument.csound
    - match: '</CsOptions>'
      scope: entity.name.tag.csound
      pop: true

  orchestra:
    # python
    - match: '{{pyrun}}'
      scope: support.function.csound
      push: python

    # orchestra header
    - match: '\b(A4|sr|kr|ksmps|nchnls(_i)?|0dbfs)\b'
      scope: constant.csound

    - include: macros
    - include: numeric

    # instrument block
    - match: '\b(instr)\b'
      scope: entity.name.function.begin.csound
      push:
        # see https://csound.com/docs/manual/OrchNamedInstruments.html
        # for the plus ( + ) sign to perform instr after the others
        - match: '(\+)?[A-Za-z0-9_]+(,)?'
          scope: variable.parameter.csound # instr name(s)
          captures:
            1: keyword.operator.arithmetic.csound     # perform last   ( + )
            2: punctuation.separator.arguments.csound # separate names ( , )
        - match: '$'
          pop: true
    - match: '\b(endin)\b'
      scope: entity.name.function.end.csound

    # user defined opcode block
    - match: '\b(opcode)\b'
      scope: entity.name.function.begin.csound
      push:
        - match: '[A-Za-z][A-Za-z0-9_]+(,)\s?([0aikKS]+)(,)\s?([0aijkOPVJKopS]+)'
          scope: variable.parameter.csound # opcode name
          captures:
            1: punctuation.separator.arguments.csound
            2: storage.type.csound # opcode outtypes ( 0 a i k K S )
            3: punctuation.separator.arguments.csound
            4: storage.type.csound # opcode intypes  ( 0 a i j k O P V J K o p S )
        - match: '$'
          pop: true
    - match: '\b(endop)\b'
      scope: entity.name.function.end.csound

    # standard opcodes
    - match: '{{opcode}}|{{software_bus}}|{{osc}}'
      scope: support.function.csound
    - match: '\b({{udo}})\b'     # user defined opcodes
      scope: variable.function.csound
    - match: '{{conditional}}'   # ( if then else ... )
      scope: keyword.control.conditional.csound
    - match: '{{goto}}|{{loop}}' # ( goto loop until while ... )
      scope: keyword.control.loop.csound

    # variables
    - match: '{{variable}}'
      scope: variable.csound
      captures:
        1: storage.type.global.csound     # ( g )
        # 2: storage.modifier.type.csound # ( i k a f S)
    - match: '{{pfield}}'
      scope: constant.character.csound    # ( p )

    # punctuation
    - match: ','
      scope: punctuation.separator.arguments.csound
    - match: '\('
      scope: punctuation.section.group.begin.csound
    - match: '\)'
      scope: punctuation.section.group.end.csound
    - match: '\\(\n)' # line continuation ( \ )
      scope: punctuation.separator.continuation.line.csound

    - match: '</CsInstruments>'
      scope: entity.name.tag.csound
      pop: true

  score:
    - include: macros
    - include: numeric

    # score statements
    - match: '^\s*(a|b|B|C|d|e|f|i|m|n|q|r|s|t|v|x|y|\{|\})'
      scope: variable.function.csound

    - match: '\s\.' # explicit pfield carry
      scope: punctuation.separator.carry.csound

    - match: '(</CsScore>)'
      scope: entity.name.tag.csound
      pop: true

  macros:
    - match: '#include'
      scope: keyword.control.import.include.csound
    - match: '(#define)\s+([A-Za-z][A-Za-z0-9]*)\s+(#)?' # define macro
      captures:
        1: keyword.control.import.define.csound
        2: entity.name.constant.preprocessor.csound
        3: keyword.control.import.define.replacement.csound
    - match: '(^\s*#)|(#\s*$)' # number sign ( # ) at bol or eol (macro text delimiter)
      scope: keyword.control.import.define.replacement.csound
    - match: '(\$)([A-Za-z][A-Za-z0-9]*)' # call macro
      captures:
        1: variable.function.csound
        2: variable.csound

  numeric:
      # integer or float w/ optional leading symbols
    - match: '(\^?[-+])?[0-9]+(\.)?[0-9]*'
      scope: constant.numeric.value.csound
      captures:
        1: keyword.operator.arithmetic.csound
        2: punctuation.separator.decimal.csound

    # operators
    - match: '{{arithmetic}}' # ( + - * / ^ % )
      scope: keyword.operator.arithmetic.csound
    - match: '{{assignment}}' # ( = += -= *= /= )
      scope: keyword.operator.assignment.csound
    - match: '{{comparison}}' # ( <= >= < > == != )
      scope: keyword.operator.comparison.csound
    - match: '{{logical}}'    # ( && || ! )
      scope: keyword.operator.logical.csound

  string:
    - meta_include_prototype: false

    - match: '"' # single line string
      scope: punctuation.definition.string.begin.csound
      push:
      - meta_scope: string.quoted.double.csound
      - include: string_syntax
      - match: '"'
        scope: punctuation.definition.string.end.csound
        pop: true

    - match: '{{' # multiline string block
      scope: punctuation.definition.string.begin.csound
      push:
      - meta_scope: string.block.csound
      - include: string_syntax
      - match: '}}'
        scope: punctuation.definition.string.end.csound
        pop: true         

  string_syntax:
    - meta_include_prototype: false

    # formatted output (printf and variants)
    - match: '{{decimal}}|{{hex}}|{{char}}|{{float}}'
      scope: constant.other.placeholder.csound

    # escape sequence
    - match: '\\.'
      scope: constant.character.escape.csound

  comments:
    - meta_include_prototype: false

    - match: '^#!' # hashbang (on first line)
      scope: punctuation.definition.comment.csound
      push:
        - meta_scope: comment.line.hashbang.csound
        - match: '$'
          pop: true

    - match: ';' # single line comment
      scope: punctuation.definition.comment.csound
      push:
        - meta_scope: comment.line.semicolon.csound
        - match: '$'
          pop: true

    - match: '//' # single line comment
      scope: punctuation.definition.comment.csound
      push:
        - meta_scope: comment.line.double-slash.csound
        - match: '$'
          pop: true

    - match: '/\*' # multiline code block
      scope: punctuation.definition.comment.begin.csound
      push:
        - meta_scope: comment.block.csound
        - match: '\*/'
          scope: punctuation.definition.comment.end.csound
          pop: true

    # - match: \*/
    #   scope: invalid.illegal.stray-comment-end.csound

  python:
    - meta_include_prototype: false
    - include: comments

    - match: '{{pyrun_trigger}}' # if present
      scope: variable.csound
      captures:
        1: storage.type.global.csound # ( g )
        # 2: storage.modifier.type.csound # ( k )

    - match: '"' # single line code
      scope: punctuation.definition.python.begin.csound
      embed: Python.sublime-syntax
      escape: '"'
      escape_captures:
        0: punctuation.definition.python.end.csound
    
    - match: '{{' # multiline code block
      scope: punctuation.definition.python.begin.csound
      embed: Python.sublime-syntax
      escape: '}}'
      escape_captures:
        0: punctuation.definition.python.end.csound

    - match: '$'
      pop: true

  prototype:
    - include: comments
    - include: string