vexflow 4.0.1-beta.1 → 4.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (353) hide show
  1. package/README.md +48 -65
  2. package/build/cjs/vexflow-bravura.js +2 -2
  3. package/build/cjs/vexflow-bravura.js.map +1 -1
  4. package/build/cjs/vexflow-core.js +2 -2
  5. package/build/cjs/vexflow-core.js.map +1 -1
  6. package/build/cjs/vexflow-debug-with-tests.js +724 -697
  7. package/build/cjs/vexflow-debug-with-tests.js.map +1 -1
  8. package/build/cjs/vexflow-debug.js +550 -610
  9. package/build/cjs/vexflow-debug.js.map +1 -1
  10. package/build/cjs/vexflow-font-gonville.js +1 -1
  11. package/build/cjs/vexflow-font-gonville.js.map +1 -1
  12. package/build/cjs/vexflow-gonville.js +2 -2
  13. package/build/cjs/vexflow-gonville.js.map +1 -1
  14. package/build/cjs/vexflow-petaluma.js +2 -2
  15. package/build/cjs/vexflow-petaluma.js.map +1 -1
  16. package/build/cjs/vexflow.js +2 -2
  17. package/build/cjs/vexflow.js.map +1 -1
  18. package/build/esm/entry/vexflow-bravura.js +10 -0
  19. package/build/esm/entry/vexflow-core.js +53 -0
  20. package/build/esm/entry/vexflow-debug-with-tests.js +11 -0
  21. package/build/esm/entry/vexflow-debug.js +8 -0
  22. package/build/esm/entry/vexflow-font-bravura.js +7 -0
  23. package/build/esm/entry/vexflow-font-custom.js +7 -0
  24. package/build/esm/entry/vexflow-font-gonville.js +7 -0
  25. package/build/esm/entry/vexflow-font-petaluma.js +7 -0
  26. package/build/esm/entry/vexflow-gonville.js +10 -0
  27. package/build/esm/entry/vexflow-petaluma.js +10 -0
  28. package/build/esm/entry/vexflow.js +8 -0
  29. package/build/esm/src/accidental.js +348 -0
  30. package/build/esm/src/annotation.js +238 -0
  31. package/build/esm/src/articulation.js +267 -0
  32. package/build/esm/src/barnote.js +58 -0
  33. package/build/esm/src/beam.js +644 -0
  34. package/build/esm/src/bend.js +202 -0
  35. package/build/esm/src/boundingbox.js +59 -0
  36. package/build/esm/src/boundingboxcomputation.js +107 -0
  37. package/build/esm/src/canvascontext.js +202 -0
  38. package/build/esm/src/chordsymbol.js +578 -0
  39. package/build/esm/src/clef.js +153 -0
  40. package/build/esm/src/clefnote.js +65 -0
  41. package/build/esm/src/crescendo.js +77 -0
  42. package/build/esm/src/curve.js +118 -0
  43. package/build/esm/src/dot.js +137 -0
  44. package/build/esm/src/easyscore.js +374 -0
  45. package/build/esm/src/element.js +216 -0
  46. package/build/esm/src/factory.js +445 -0
  47. package/build/esm/src/flow.js +288 -0
  48. package/build/esm/src/font.js +262 -0
  49. package/build/esm/src/fonts/bravura_glyphs.js +3239 -0
  50. package/build/esm/src/fonts/bravura_metrics.js +507 -0
  51. package/build/esm/src/fonts/custom_glyphs.js +78 -0
  52. package/build/esm/src/fonts/custom_metrics.js +5 -0
  53. package/build/esm/src/fonts/gonville_glyphs.js +828 -0
  54. package/build/esm/src/fonts/gonville_metrics.js +421 -0
  55. package/build/esm/src/fonts/load_all.js +10 -0
  56. package/build/esm/src/fonts/load_bravura.js +6 -0
  57. package/build/esm/src/fonts/load_custom.js +6 -0
  58. package/build/esm/src/fonts/load_gonville.js +6 -0
  59. package/build/esm/src/fonts/load_petaluma.js +6 -0
  60. package/build/esm/src/fonts/petaluma_glyphs.js +1335 -0
  61. package/build/esm/src/fonts/petaluma_metrics.js +536 -0
  62. package/build/esm/src/fonts/petalumascript_glyphs.js +863 -0
  63. package/build/esm/src/fonts/robotoslab_glyphs.js +863 -0
  64. package/build/esm/src/fonts/textfonts.js +44 -0
  65. package/build/esm/src/formatter.js +585 -0
  66. package/build/esm/src/fraction.js +171 -0
  67. package/build/esm/src/frethandfinger.js +156 -0
  68. package/build/esm/src/ghostnote.js +50 -0
  69. package/build/esm/src/glyph.js +337 -0
  70. package/build/esm/src/glyphnote.js +55 -0
  71. package/build/esm/src/gracenote.js +133 -0
  72. package/build/esm/src/gracenotegroup.js +128 -0
  73. package/build/esm/src/gracetabnote.js +12 -0
  74. package/build/esm/src/index.js +89 -0
  75. package/build/esm/src/keymanager.js +99 -0
  76. package/build/esm/src/keysignature.js +250 -0
  77. package/build/esm/src/keysignote.js +28 -0
  78. package/build/esm/src/modifier.js +128 -0
  79. package/build/esm/src/modifiercontext.js +110 -0
  80. package/build/esm/src/multimeasurerest.js +173 -0
  81. package/build/esm/src/music.js +322 -0
  82. package/build/esm/src/note.js +371 -0
  83. package/build/esm/src/notehead.js +169 -0
  84. package/build/esm/src/notesubgroup.js +59 -0
  85. package/build/esm/src/ornament.js +206 -0
  86. package/build/esm/src/parenthesis.js +76 -0
  87. package/build/esm/src/parser.js +164 -0
  88. package/build/esm/src/pedalmarking.js +192 -0
  89. package/build/esm/src/registry.js +81 -0
  90. package/build/esm/src/rendercontext.js +24 -0
  91. package/build/esm/src/renderer.js +112 -0
  92. package/build/esm/src/repeatnote.js +22 -0
  93. package/build/esm/src/stave.js +547 -0
  94. package/build/esm/src/stavebarline.js +182 -0
  95. package/build/esm/src/staveconnector.js +196 -0
  96. package/build/esm/src/stavehairpin.js +120 -0
  97. package/build/esm/src/staveline.js +215 -0
  98. package/build/esm/src/stavemodifier.js +77 -0
  99. package/build/esm/src/stavenote.js +860 -0
  100. package/build/esm/src/staverepetition.js +155 -0
  101. package/build/esm/src/stavesection.js +58 -0
  102. package/build/esm/src/stavetempo.js +91 -0
  103. package/build/esm/src/stavetext.js +82 -0
  104. package/build/esm/src/stavetie.js +141 -0
  105. package/build/esm/src/stavevolta.js +67 -0
  106. package/build/esm/src/stem.js +131 -0
  107. package/build/esm/src/stemmablenote.js +193 -0
  108. package/build/esm/src/stringnumber.js +231 -0
  109. package/build/esm/src/strokes.js +200 -0
  110. package/build/esm/src/svgcontext.js +414 -0
  111. package/build/esm/src/system.js +109 -0
  112. package/build/esm/src/tables.js +1102 -0
  113. package/build/esm/src/tabnote.js +299 -0
  114. package/build/esm/src/tabslide.js +76 -0
  115. package/build/esm/src/tabstave.js +17 -0
  116. package/build/esm/src/tabtie.js +19 -0
  117. package/build/esm/src/textbracket.js +144 -0
  118. package/build/esm/src/textdynamics.js +81 -0
  119. package/build/esm/src/textformatter.js +177 -0
  120. package/build/esm/src/textnote.js +174 -0
  121. package/build/esm/src/tickable.js +214 -0
  122. package/build/esm/src/tickcontext.js +170 -0
  123. package/build/esm/src/timesigglyph.js +85 -0
  124. package/build/esm/src/timesignature.js +89 -0
  125. package/build/esm/src/timesignote.js +32 -0
  126. package/build/esm/src/tremolo.js +47 -0
  127. package/build/esm/src/tuning.js +54 -0
  128. package/build/esm/src/tuplet.js +240 -0
  129. package/build/esm/src/typeguard.js +30 -0
  130. package/build/esm/src/util.js +58 -0
  131. package/build/esm/src/version.js +3 -3
  132. package/build/esm/src/vex.js +51 -0
  133. package/build/esm/src/vibrato.js +100 -0
  134. package/build/esm/src/vibratobracket.js +50 -0
  135. package/build/esm/src/voice.js +187 -0
  136. package/build/esm/src/web.js +15 -0
  137. package/build/esm/tests/accidental_tests.js +974 -0
  138. package/build/esm/tests/annotation_tests.js +390 -0
  139. package/build/esm/tests/articulation_tests.js +365 -0
  140. package/build/esm/tests/auto_beam_formatting_tests.js +548 -0
  141. package/build/esm/tests/bach_tests.js +335 -0
  142. package/build/esm/tests/barline_tests.js +52 -0
  143. package/build/esm/tests/beam_tests.js +614 -0
  144. package/build/esm/tests/bend_tests.js +215 -0
  145. package/build/esm/tests/boundingbox_tests.js +53 -0
  146. package/build/esm/tests/boundingboxcomputation_tests.js +183 -0
  147. package/build/esm/tests/chordsymbol_tests.js +320 -0
  148. package/build/esm/tests/clef_tests.js +131 -0
  149. package/build/esm/tests/curve_tests.js +118 -0
  150. package/build/esm/tests/dot_tests.js +123 -0
  151. package/build/esm/tests/easyscore_tests.js +462 -0
  152. package/build/esm/tests/factory_tests.js +44 -0
  153. package/build/esm/tests/font_tests.js +135 -0
  154. package/build/esm/tests/formatter/framestack.js +61 -0
  155. package/build/esm/tests/formatter/tests.js +203 -0
  156. package/build/esm/tests/formatter_tests.js +670 -0
  157. package/build/esm/tests/fraction_tests.js +72 -0
  158. package/build/esm/tests/ghostnote_tests.js +77 -0
  159. package/build/esm/tests/glyphnote_tests.js +113 -0
  160. package/build/esm/tests/gracenote_tests.js +413 -0
  161. package/build/esm/tests/gracetabnote_tests.js +79 -0
  162. package/build/esm/tests/index.js +68 -0
  163. package/build/esm/tests/key_clef_tests.js +103 -0
  164. package/build/esm/tests/keymanager_tests.js +68 -0
  165. package/build/esm/tests/keysignature_tests.js +308 -0
  166. package/build/esm/tests/mocks.js +71 -0
  167. package/build/esm/tests/modifier_tests.js +24 -0
  168. package/build/esm/tests/multimeasurerest_tests.js +141 -0
  169. package/build/esm/tests/music_tests.js +161 -0
  170. package/build/esm/tests/notehead_tests.js +137 -0
  171. package/build/esm/tests/notesubgroup_tests.js +149 -0
  172. package/build/esm/tests/offscreencanvas_tests.js +47 -0
  173. package/build/esm/tests/ornament_tests.js +298 -0
  174. package/build/esm/tests/parser_tests.js +122 -0
  175. package/build/esm/tests/pedalmarking_tests.js +64 -0
  176. package/build/esm/tests/percussion_tests.js +180 -0
  177. package/build/esm/tests/registry_tests.js +64 -0
  178. package/build/esm/tests/renderer_tests.js +113 -0
  179. package/build/esm/tests/rests_tests.js +248 -0
  180. package/build/esm/tests/rhythm_tests.js +357 -0
  181. package/build/esm/tests/stave_tests.js +560 -0
  182. package/build/esm/tests/staveconnector_tests.js +402 -0
  183. package/build/esm/tests/stavehairpin_tests.js +90 -0
  184. package/build/esm/tests/staveline_tests.js +122 -0
  185. package/build/esm/tests/stavemodifier_tests.js +51 -0
  186. package/build/esm/tests/stavenote_tests.js +867 -0
  187. package/build/esm/tests/stavetie_tests.js +108 -0
  188. package/build/esm/tests/stringnumber_tests.js +259 -0
  189. package/build/esm/tests/strokes_tests.js +275 -0
  190. package/build/esm/tests/style_tests.js +98 -0
  191. package/build/esm/tests/support/qunit.js +2765 -0
  192. package/build/esm/tests/tabnote_tests.js +474 -0
  193. package/build/esm/tests/tabslide_tests.js +135 -0
  194. package/build/esm/tests/tabstave_tests.js +23 -0
  195. package/build/esm/tests/tabtie_tests.js +173 -0
  196. package/build/esm/tests/textbracket_tests.js +100 -0
  197. package/build/esm/tests/textformatter_tests.js +24 -0
  198. package/build/esm/tests/textnote_tests.js +215 -0
  199. package/build/esm/tests/threevoice_tests.js +132 -0
  200. package/build/esm/tests/tickcontext_tests.js +36 -0
  201. package/build/esm/tests/timesignature_tests.js +134 -0
  202. package/build/esm/tests/tremolo_tests.js +75 -0
  203. package/build/esm/tests/tuning_tests.js +56 -0
  204. package/build/esm/tests/tuplet_tests.js +450 -0
  205. package/build/esm/tests/typeguard_tests.js +82 -0
  206. package/build/esm/tests/vexflow_test_helpers.js +266 -0
  207. package/build/esm/tests/vf_prefix_tests.js +115 -0
  208. package/build/esm/tests/vibrato_tests.js +92 -0
  209. package/build/esm/tests/vibratobracket_tests.js +45 -0
  210. package/build/esm/tests/voice_tests.js +69 -0
  211. package/build/types/entry/vexflow-bravura.d.ts +2 -0
  212. package/build/types/entry/vexflow-core.d.ts +2 -0
  213. package/build/types/entry/vexflow-debug.d.ts +2 -0
  214. package/build/types/entry/vexflow-font-bravura.d.ts +3771 -0
  215. package/build/types/entry/vexflow-font-custom.d.ts +86 -0
  216. package/build/types/entry/vexflow-font-gonville.d.ts +1267 -0
  217. package/build/types/entry/vexflow-font-petaluma.d.ts +1896 -0
  218. package/build/types/entry/vexflow-gonville.d.ts +2 -0
  219. package/build/types/entry/vexflow-petaluma.d.ts +2 -0
  220. package/build/types/entry/vexflow.d.ts +2 -0
  221. package/build/types/src/accidental.d.ts +66 -0
  222. package/build/types/src/annotation.d.ts +61 -0
  223. package/build/types/src/articulation.d.ts +62 -0
  224. package/build/types/src/barnote.d.ts +29 -0
  225. package/build/types/src/beam.d.ts +153 -0
  226. package/build/types/src/bend.d.ts +73 -0
  227. package/build/types/src/boundingbox.d.ts +42 -0
  228. package/build/types/src/boundingboxcomputation.d.ts +33 -0
  229. package/build/types/src/canvascontext.d.ts +89 -0
  230. package/build/types/src/chordsymbol.d.ts +149 -0
  231. package/build/types/src/clef.d.ts +48 -0
  232. package/build/types/src/clefnote.d.ts +25 -0
  233. package/build/types/src/crescendo.d.ts +27 -0
  234. package/build/types/src/curve.d.ts +41 -0
  235. package/build/types/src/dot.d.ts +20 -0
  236. package/build/types/src/easyscore.d.ts +152 -0
  237. package/build/types/src/element.d.ts +202 -0
  238. package/build/types/src/factory.d.ts +274 -0
  239. package/build/types/src/flow.d.ts +260 -0
  240. package/build/types/src/font.d.ts +180 -0
  241. package/build/types/src/fonts/bravura_glyphs.d.ts +3239 -0
  242. package/build/types/src/fonts/bravura_metrics.d.ts +533 -0
  243. package/build/types/src/fonts/custom_glyphs.d.ts +78 -0
  244. package/build/types/src/fonts/custom_metrics.d.ts +5 -0
  245. package/build/types/src/fonts/gonville_glyphs.d.ts +828 -0
  246. package/build/types/src/fonts/gonville_metrics.d.ts +440 -0
  247. package/build/types/src/fonts/load_all.d.ts +1 -0
  248. package/build/types/src/fonts/load_bravura.d.ts +1 -0
  249. package/build/types/src/fonts/load_custom.d.ts +1 -0
  250. package/build/types/src/fonts/load_gonville.d.ts +1 -0
  251. package/build/types/src/fonts/load_petaluma.d.ts +1 -0
  252. package/build/types/src/fonts/petaluma_glyphs.d.ts +1335 -0
  253. package/build/types/src/fonts/petaluma_metrics.d.ts +562 -0
  254. package/build/types/src/fonts/petalumascript_glyphs.d.ts +863 -0
  255. package/build/types/src/fonts/robotoslab_glyphs.d.ts +863 -0
  256. package/build/types/src/fonts/textfonts.d.ts +1 -0
  257. package/build/types/src/formatter.d.ts +203 -0
  258. package/build/types/src/fraction.d.ts +62 -0
  259. package/build/types/src/frethandfinger.d.ts +22 -0
  260. package/build/types/src/ghostnote.d.ts +16 -0
  261. package/build/types/src/glyph.d.ts +141 -0
  262. package/build/types/src/glyphnote.d.ts +17 -0
  263. package/build/types/src/gracenote.d.ts +19 -0
  264. package/build/types/src/gracenotegroup.d.ts +33 -0
  265. package/build/types/src/gracetabnote.d.ts +5 -0
  266. package/build/types/src/index.d.ts +89 -0
  267. package/build/types/src/keymanager.d.ts +25 -0
  268. package/build/types/src/keysignature.d.ts +50 -0
  269. package/build/types/src/keysignote.d.ts +11 -0
  270. package/build/types/src/modifier.d.ts +97 -0
  271. package/build/types/src/modifiercontext.d.ts +45 -0
  272. package/build/types/src/multimeasurerest.d.ts +61 -0
  273. package/build/types/src/music.d.ts +91 -0
  274. package/build/types/src/note.d.ts +232 -0
  275. package/build/types/src/notehead.d.ts +70 -0
  276. package/build/types/src/notesubgroup.d.ts +18 -0
  277. package/build/types/src/ornament.d.ts +76 -0
  278. package/build/types/src/parenthesis.d.ts +22 -0
  279. package/build/types/src/parser.d.ts +45 -0
  280. package/build/types/src/pedalmarking.d.ts +69 -0
  281. package/build/types/src/registry.d.ts +40 -0
  282. package/build/types/src/rendercontext.d.ts +64 -0
  283. package/build/types/src/renderer.d.ts +35 -0
  284. package/build/types/src/repeatnote.d.ts +6 -0
  285. package/build/types/src/stave.d.ts +186 -0
  286. package/build/types/src/stavebarline.d.ts +28 -0
  287. package/build/types/src/staveconnector.d.ts +67 -0
  288. package/build/types/src/stavehairpin.d.ts +56 -0
  289. package/build/types/src/staveline.d.ts +54 -0
  290. package/build/types/src/stavemodifier.d.ts +44 -0
  291. package/build/types/src/stavenote.d.ts +154 -0
  292. package/build/types/src/staverepetition.d.ts +32 -0
  293. package/build/types/src/stavesection.d.ts +15 -0
  294. package/build/types/src/stavetempo.d.ts +25 -0
  295. package/build/types/src/stavetext.d.ts +25 -0
  296. package/build/types/src/stavetie.d.ts +59 -0
  297. package/build/types/src/stavevolta.d.ts +21 -0
  298. package/build/types/src/stem.d.ts +58 -0
  299. package/build/types/src/stemmablenote.d.ts +39 -0
  300. package/build/types/src/stringnumber.d.ts +27 -0
  301. package/build/types/src/strokes.d.ts +33 -0
  302. package/build/types/src/svgcontext.d.ts +131 -0
  303. package/build/types/src/system.d.ts +92 -0
  304. package/build/types/src/tables.d.ts +96 -0
  305. package/build/types/src/tabnote.d.ts +44 -0
  306. package/build/types/src/tabslide.d.ts +34 -0
  307. package/build/types/src/tabstave.d.ts +7 -0
  308. package/build/types/src/tabtie.d.ts +18 -0
  309. package/build/types/src/textbracket.d.ts +55 -0
  310. package/build/types/src/textdynamics.d.ts +39 -0
  311. package/build/types/src/textformatter.d.ts +109 -0
  312. package/build/types/src/textnote.d.ts +49 -0
  313. package/build/types/src/tickable.d.ts +140 -0
  314. package/build/types/src/tickcontext.d.ts +82 -0
  315. package/build/types/src/timesigglyph.d.ts +14 -0
  316. package/build/types/src/timesignature.d.ts +26 -0
  317. package/build/types/src/timesignote.d.ts +11 -0
  318. package/build/types/src/tremolo.d.ts +17 -0
  319. package/build/types/src/tuning.d.ts +23 -0
  320. package/build/types/src/tuplet.d.ts +105 -0
  321. package/build/types/src/typeguard.d.ts +99 -0
  322. package/build/types/src/util.d.ts +27 -0
  323. package/build/types/src/version.d.ts +3 -0
  324. package/build/types/src/vex.d.ts +18 -0
  325. package/build/types/src/vibrato.d.ts +29 -0
  326. package/build/types/src/vibratobracket.d.ts +33 -0
  327. package/build/types/src/voice.d.ts +108 -0
  328. package/build/types/src/web.d.ts +2 -0
  329. package/entry/vexflow-bravura.ts +3 -3
  330. package/entry/vexflow-core.ts +3 -3
  331. package/entry/vexflow-debug-with-tests.ts +16 -2
  332. package/entry/vexflow-debug.ts +11 -3
  333. package/entry/vexflow-gonville.ts +3 -3
  334. package/entry/vexflow-petaluma.ts +3 -3
  335. package/entry/vexflow.ts +3 -3
  336. package/package.json +1 -1
  337. package/src/annotation.ts +38 -6
  338. package/src/articulation.ts +8 -2
  339. package/src/beam.ts +53 -6
  340. package/src/easyscore.ts +11 -1
  341. package/src/factory.ts +16 -2
  342. package/src/flow.ts +35 -20
  343. package/src/font.ts +0 -4
  344. package/src/fonts/gonville_glyphs.ts +4 -4
  345. package/src/formatter.ts +24 -8
  346. package/src/glyph.ts +8 -0
  347. package/src/index.ts +2 -7
  348. package/src/note.ts +2 -1
  349. package/src/staveline.ts +2 -5
  350. package/src/stavenote.ts +13 -9
  351. package/src/stavetext.ts +3 -3
  352. package/src/system.ts +1 -7
  353. package/src/textnote.ts +9 -11
@@ -0,0 +1,238 @@
1
+ import { Element } from './element.js';
2
+ import { Modifier, ModifierPosition } from './modifier.js';
3
+ import { Stem } from './stem.js';
4
+ import { Tables } from './tables.js';
5
+ import { TextFormatter } from './textformatter.js';
6
+ import { isStemmableNote, isTabNote } from './typeguard.js';
7
+ import { log } from './util.js';
8
+ function L(...args) {
9
+ if (Annotation.DEBUG)
10
+ log('Vex.Flow.Annotation', args);
11
+ }
12
+ export var AnnotationHorizontalJustify;
13
+ (function (AnnotationHorizontalJustify) {
14
+ AnnotationHorizontalJustify[AnnotationHorizontalJustify["LEFT"] = 1] = "LEFT";
15
+ AnnotationHorizontalJustify[AnnotationHorizontalJustify["CENTER"] = 2] = "CENTER";
16
+ AnnotationHorizontalJustify[AnnotationHorizontalJustify["RIGHT"] = 3] = "RIGHT";
17
+ AnnotationHorizontalJustify[AnnotationHorizontalJustify["CENTER_STEM"] = 4] = "CENTER_STEM";
18
+ })(AnnotationHorizontalJustify || (AnnotationHorizontalJustify = {}));
19
+ export var AnnotationVerticalJustify;
20
+ (function (AnnotationVerticalJustify) {
21
+ AnnotationVerticalJustify[AnnotationVerticalJustify["TOP"] = 1] = "TOP";
22
+ AnnotationVerticalJustify[AnnotationVerticalJustify["CENTER"] = 2] = "CENTER";
23
+ AnnotationVerticalJustify[AnnotationVerticalJustify["BOTTOM"] = 3] = "BOTTOM";
24
+ AnnotationVerticalJustify[AnnotationVerticalJustify["CENTER_STEM"] = 4] = "CENTER_STEM";
25
+ })(AnnotationVerticalJustify || (AnnotationVerticalJustify = {}));
26
+ export class Annotation extends Modifier {
27
+ constructor(text) {
28
+ super();
29
+ this.text = text;
30
+ this.horizontalJustification = AnnotationHorizontalJustify.CENTER;
31
+ this.verticalJustification = AnnotationVerticalJustify.TOP;
32
+ this.resetFont();
33
+ this.setWidth(Tables.textWidth(text));
34
+ }
35
+ static get CATEGORY() {
36
+ return "Annotation";
37
+ }
38
+ static get minAnnotationPadding() {
39
+ const musicFont = Tables.currentMusicFont();
40
+ return musicFont.lookupMetric('glyphs.noteHead.minPadding');
41
+ }
42
+ static format(annotations, state) {
43
+ if (!annotations || annotations.length === 0)
44
+ return false;
45
+ let leftWidth = 0;
46
+ let rightWidth = 0;
47
+ let maxLeftGlyphWidth = 0;
48
+ let maxRightGlyphWidth = 0;
49
+ for (let i = 0; i < annotations.length; ++i) {
50
+ const annotation = annotations[i];
51
+ const textFormatter = TextFormatter.create(annotation.textFont);
52
+ const textLines = (5 + textFormatter.maxHeight) / Tables.STAVE_LINE_DISTANCE;
53
+ let verticalSpaceNeeded = textLines;
54
+ const note = annotation.checkAttachedNote();
55
+ const glyphWidth = note.getGlyph().getWidth();
56
+ const textWidth = textFormatter.getWidthForTextInPx(annotation.text);
57
+ if (annotation.horizontalJustification === AnnotationHorizontalJustify.LEFT) {
58
+ maxLeftGlyphWidth = Math.max(glyphWidth, maxLeftGlyphWidth);
59
+ leftWidth = Math.max(leftWidth, textWidth) + Annotation.minAnnotationPadding;
60
+ }
61
+ else if (annotation.horizontalJustification === AnnotationHorizontalJustify.RIGHT) {
62
+ maxRightGlyphWidth = Math.max(glyphWidth, maxLeftGlyphWidth);
63
+ rightWidth = Math.max(rightWidth, textWidth);
64
+ }
65
+ else {
66
+ leftWidth = Math.max(leftWidth, textWidth / 2) + Annotation.minAnnotationPadding;
67
+ rightWidth = Math.max(rightWidth, textWidth / 2);
68
+ maxLeftGlyphWidth = Math.max(glyphWidth / 2, maxLeftGlyphWidth);
69
+ maxRightGlyphWidth = Math.max(glyphWidth / 2, maxRightGlyphWidth);
70
+ }
71
+ const stave = note.getStave();
72
+ const stemDirection = note.hasStem() ? note.getStemDirection() : Stem.UP;
73
+ let stemHeight = 0;
74
+ let lines = 5;
75
+ if (isTabNote(note)) {
76
+ if (note.render_options.draw_stem) {
77
+ const stem = note.getStem();
78
+ if (stem) {
79
+ stemHeight = Math.abs(stem.getHeight()) / Tables.STAVE_LINE_DISTANCE;
80
+ }
81
+ }
82
+ else {
83
+ stemHeight = 0;
84
+ }
85
+ }
86
+ else if (isStemmableNote(note)) {
87
+ const stem = note.getStem();
88
+ if (stem && note.getNoteType() === 'n') {
89
+ stemHeight = Math.abs(stem.getHeight()) / Tables.STAVE_LINE_DISTANCE;
90
+ }
91
+ }
92
+ if (stave) {
93
+ lines = stave.getNumLines();
94
+ }
95
+ if (annotation.verticalJustification === this.VerticalJustify.TOP) {
96
+ let noteLine = note.getLineNumber(true);
97
+ if (isTabNote(note)) {
98
+ noteLine = lines - (note.leastString() - 0.5);
99
+ }
100
+ if (stemDirection === Stem.UP) {
101
+ noteLine += stemHeight;
102
+ }
103
+ const curTop = noteLine + state.top_text_line + 0.5;
104
+ if (curTop < lines) {
105
+ annotation.setTextLine(lines - noteLine);
106
+ verticalSpaceNeeded += lines - noteLine;
107
+ state.top_text_line = verticalSpaceNeeded;
108
+ }
109
+ else {
110
+ annotation.setTextLine(state.top_text_line);
111
+ state.top_text_line += verticalSpaceNeeded;
112
+ }
113
+ }
114
+ else if (annotation.verticalJustification === this.VerticalJustify.BOTTOM) {
115
+ let noteLine = lines - note.getLineNumber();
116
+ if (isTabNote(note)) {
117
+ noteLine = note.greatestString() - 1;
118
+ }
119
+ if (stemDirection === Stem.DOWN) {
120
+ noteLine += stemHeight;
121
+ }
122
+ const curBottom = noteLine + state.text_line + 1;
123
+ if (curBottom < lines) {
124
+ annotation.setTextLine(lines - curBottom);
125
+ verticalSpaceNeeded += lines - curBottom;
126
+ state.text_line = verticalSpaceNeeded;
127
+ }
128
+ else {
129
+ annotation.setTextLine(state.text_line);
130
+ state.text_line += verticalSpaceNeeded;
131
+ }
132
+ }
133
+ else {
134
+ annotation.setTextLine(state.text_line);
135
+ }
136
+ }
137
+ const rightOverlap = Math.min(Math.max(rightWidth - maxRightGlyphWidth, 0), Math.max(rightWidth - state.right_shift, 0));
138
+ const leftOverlap = Math.min(Math.max(leftWidth - maxLeftGlyphWidth, 0), Math.max(leftWidth - state.left_shift, 0));
139
+ state.left_shift += leftOverlap;
140
+ state.right_shift += rightOverlap;
141
+ return true;
142
+ }
143
+ setVerticalJustification(just) {
144
+ this.verticalJustification = typeof just === 'string' ? Annotation.VerticalJustifyString[just] : just;
145
+ return this;
146
+ }
147
+ getJustification() {
148
+ return this.horizontalJustification;
149
+ }
150
+ setJustification(just) {
151
+ this.horizontalJustification = typeof just === 'string' ? Annotation.HorizontalJustifyString[just] : just;
152
+ return this;
153
+ }
154
+ draw() {
155
+ const ctx = this.checkContext();
156
+ const note = this.checkAttachedNote();
157
+ const stemDirection = note.hasStem() ? note.getStemDirection() : Stem.UP;
158
+ const textFormatter = TextFormatter.create(this.textFont);
159
+ const start = note.getModifierStartXY(ModifierPosition.ABOVE, this.index);
160
+ this.setRendered();
161
+ ctx.save();
162
+ this.applyStyle();
163
+ const classString = Object.keys(this.getAttribute('classes')).join(' ');
164
+ ctx.openGroup(classString, this.getAttribute('id'));
165
+ ctx.setFont(this.textFont);
166
+ const text_width = ctx.measureText(this.text).width;
167
+ const text_height = textFormatter.maxHeight + 2;
168
+ let x;
169
+ let y;
170
+ if (this.horizontalJustification === AnnotationHorizontalJustify.LEFT) {
171
+ x = start.x;
172
+ }
173
+ else if (this.horizontalJustification === AnnotationHorizontalJustify.RIGHT) {
174
+ x = start.x - text_width;
175
+ }
176
+ else if (this.horizontalJustification === AnnotationHorizontalJustify.CENTER) {
177
+ x = start.x - text_width / 2;
178
+ }
179
+ else {
180
+ x = note.getStemX() - text_width / 2;
181
+ }
182
+ let stem_ext = {};
183
+ let spacing = 0;
184
+ const has_stem = note.hasStem();
185
+ const stave = note.checkStave();
186
+ if (has_stem) {
187
+ stem_ext = note.checkStem().getExtents();
188
+ spacing = stave.getSpacingBetweenLines();
189
+ }
190
+ if (this.verticalJustification === AnnotationVerticalJustify.BOTTOM) {
191
+ const ys = note.getYs();
192
+ y = ys.reduce((a, b) => (a > b ? a : b));
193
+ y += (this.text_line + 1) * Tables.STAVE_LINE_DISTANCE + text_height;
194
+ if (has_stem && stemDirection === Stem.DOWN) {
195
+ y = Math.max(y, stem_ext.topY + text_height + spacing * this.text_line);
196
+ }
197
+ }
198
+ else if (this.verticalJustification === AnnotationVerticalJustify.CENTER) {
199
+ const yt = note.getYForTopText(this.text_line) - 1;
200
+ const yb = stave.getYForBottomText(this.text_line);
201
+ y = yt + (yb - yt) / 2 + text_height / 2;
202
+ }
203
+ else if (this.verticalJustification === AnnotationVerticalJustify.TOP) {
204
+ y = note.getYs()[0] - (this.text_line + 1) * Tables.STAVE_LINE_DISTANCE;
205
+ if (has_stem && stemDirection === Stem.UP) {
206
+ spacing = stem_ext.topY < stave.getTopLineTopY() ? Tables.STAVE_LINE_DISTANCE : spacing;
207
+ y = Math.min(y, stem_ext.topY - spacing * (this.text_line + 1));
208
+ }
209
+ }
210
+ else {
211
+ const extents = note.getStemExtents();
212
+ y = extents.topY + (extents.baseY - extents.topY) / 2 + text_height / 2;
213
+ }
214
+ L('Rendering annotation: ', this.text, x, y);
215
+ ctx.fillText(this.text, x, y);
216
+ ctx.closeGroup();
217
+ this.restoreStyle();
218
+ ctx.restore();
219
+ }
220
+ }
221
+ Annotation.DEBUG = false;
222
+ Annotation.TEXT_FONT = Object.assign({}, Element.TEXT_FONT);
223
+ Annotation.HorizontalJustify = AnnotationHorizontalJustify;
224
+ Annotation.HorizontalJustifyString = {
225
+ left: AnnotationHorizontalJustify.LEFT,
226
+ right: AnnotationHorizontalJustify.RIGHT,
227
+ center: AnnotationHorizontalJustify.CENTER,
228
+ centerStem: AnnotationHorizontalJustify.CENTER_STEM,
229
+ };
230
+ Annotation.VerticalJustify = AnnotationVerticalJustify;
231
+ Annotation.VerticalJustifyString = {
232
+ above: AnnotationVerticalJustify.TOP,
233
+ top: AnnotationVerticalJustify.TOP,
234
+ below: AnnotationVerticalJustify.BOTTOM,
235
+ bottom: AnnotationVerticalJustify.BOTTOM,
236
+ center: AnnotationVerticalJustify.CENTER,
237
+ centerStem: AnnotationVerticalJustify.CENTER_STEM,
238
+ };
@@ -0,0 +1,267 @@
1
+ import { Glyph } from './glyph.js';
2
+ import { Modifier } from './modifier.js';
3
+ import { Stem } from './stem.js';
4
+ import { Tables } from './tables.js';
5
+ import { isGraceNote, isStaveNote, isStemmableNote, isTabNote } from './typeguard.js';
6
+ import { defined, log, RuntimeError } from './util.js';
7
+ function L(...args) {
8
+ if (Articulation.DEBUG)
9
+ log('Vex.Flow.Articulation', args);
10
+ }
11
+ const { ABOVE, BELOW } = Modifier.Position;
12
+ function roundToNearestHalf(mathFn, value) {
13
+ return mathFn(value / 0.5) * 0.5;
14
+ }
15
+ function isWithinLines(line, position) {
16
+ return position === ABOVE ? line <= 5 : line >= 1;
17
+ }
18
+ function getRoundingFunction(line, position) {
19
+ if (isWithinLines(line, position)) {
20
+ if (position === ABOVE) {
21
+ return Math.ceil;
22
+ }
23
+ else {
24
+ return Math.floor;
25
+ }
26
+ }
27
+ else {
28
+ return Math.round;
29
+ }
30
+ }
31
+ function snapLineToStaff(canSitBetweenLines, line, position, offsetDirection) {
32
+ const snappedLine = roundToNearestHalf(getRoundingFunction(line, position), line);
33
+ const canSnapToStaffSpace = canSitBetweenLines && isWithinLines(snappedLine, position);
34
+ const onStaffLine = snappedLine % 1 === 0;
35
+ if (canSnapToStaffSpace && onStaffLine) {
36
+ const HALF_STAFF_SPACE = 0.5;
37
+ return snappedLine + HALF_STAFF_SPACE * -offsetDirection;
38
+ }
39
+ else {
40
+ return snappedLine;
41
+ }
42
+ }
43
+ const isStaveOrGraceNote = (note) => isStaveNote(note) || isGraceNote(note);
44
+ function getTopY(note, textLine) {
45
+ const stemDirection = note.getStemDirection();
46
+ const { topY: stemTipY, baseY: stemBaseY } = note.getStemExtents();
47
+ if (isStaveOrGraceNote(note)) {
48
+ if (note.hasStem()) {
49
+ if (stemDirection === Stem.UP) {
50
+ return stemTipY;
51
+ }
52
+ else {
53
+ return stemBaseY;
54
+ }
55
+ }
56
+ else {
57
+ return Math.min(...note.getYs());
58
+ }
59
+ }
60
+ else if (isTabNote(note)) {
61
+ if (note.hasStem()) {
62
+ if (stemDirection === Stem.UP) {
63
+ return stemTipY;
64
+ }
65
+ else {
66
+ return note.checkStave().getYForTopText(textLine);
67
+ }
68
+ }
69
+ else {
70
+ return note.checkStave().getYForTopText(textLine);
71
+ }
72
+ }
73
+ else {
74
+ throw new RuntimeError('UnknownCategory', 'Only can get the top and bottom ys of stavenotes and tabnotes');
75
+ }
76
+ }
77
+ function getBottomY(note, textLine) {
78
+ const stemDirection = note.getStemDirection();
79
+ const { topY: stemTipY, baseY: stemBaseY } = note.getStemExtents();
80
+ if (isStaveOrGraceNote(note)) {
81
+ if (note.hasStem()) {
82
+ if (stemDirection === Stem.UP) {
83
+ return stemBaseY;
84
+ }
85
+ else {
86
+ return stemTipY;
87
+ }
88
+ }
89
+ else {
90
+ return Math.max(...note.getYs());
91
+ }
92
+ }
93
+ else if (isTabNote(note)) {
94
+ if (note.hasStem()) {
95
+ if (stemDirection === Stem.UP) {
96
+ return note.checkStave().getYForBottomText(textLine);
97
+ }
98
+ else {
99
+ return stemTipY;
100
+ }
101
+ }
102
+ else {
103
+ return note.checkStave().getYForBottomText(textLine);
104
+ }
105
+ }
106
+ else {
107
+ throw new RuntimeError('UnknownCategory', 'Only can get the top and bottom ys of stavenotes and tabnotes');
108
+ }
109
+ }
110
+ function getInitialOffset(note, position) {
111
+ const isOnStemTip = (position === ABOVE && note.getStemDirection() === Stem.UP) ||
112
+ (position === BELOW && note.getStemDirection() === Stem.DOWN);
113
+ if (isStaveOrGraceNote(note)) {
114
+ if (note.hasStem() && isOnStemTip) {
115
+ return 0.5;
116
+ }
117
+ else {
118
+ return 1;
119
+ }
120
+ }
121
+ else {
122
+ if (note.hasStem() && isOnStemTip) {
123
+ return 1;
124
+ }
125
+ else {
126
+ return 0;
127
+ }
128
+ }
129
+ }
130
+ export class Articulation extends Modifier {
131
+ constructor(type) {
132
+ super();
133
+ this.type = type;
134
+ this.position = BELOW;
135
+ this.render_options = {
136
+ font_scale: 38,
137
+ };
138
+ this.reset();
139
+ }
140
+ static get CATEGORY() {
141
+ return "Articulation";
142
+ }
143
+ static format(articulations, state) {
144
+ if (!articulations || articulations.length === 0)
145
+ return false;
146
+ const margin = 0.5;
147
+ let maxGlyphWidth = 0;
148
+ const getIncrement = (articulation, line, position) => roundToNearestHalf(getRoundingFunction(line, position), defined(articulation.glyph.getMetrics().height) / 10 + margin);
149
+ articulations.forEach((articulation) => {
150
+ const note = articulation.checkAttachedNote();
151
+ maxGlyphWidth = Math.max(note.getGlyph().getWidth(), maxGlyphWidth);
152
+ let lines = 5;
153
+ const stemDirection = note.hasStem() ? note.getStemDirection() : Stem.UP;
154
+ let stemHeight = 0;
155
+ if (isStemmableNote(note)) {
156
+ const stem = note.getStem();
157
+ if (stem) {
158
+ stemHeight = Math.abs(stem.getHeight()) / Tables.STAVE_LINE_DISTANCE;
159
+ }
160
+ }
161
+ const stave = note.getStave();
162
+ if (stave) {
163
+ lines = stave.getNumLines();
164
+ }
165
+ if (articulation.getPosition() === ABOVE) {
166
+ let noteLine = note.getLineNumber(true);
167
+ if (stemDirection === Stem.UP) {
168
+ noteLine += stemHeight;
169
+ }
170
+ let increment = getIncrement(articulation, state.top_text_line, ABOVE);
171
+ const curTop = noteLine + state.top_text_line + 0.5;
172
+ if (!articulation.articulation.between_lines && curTop < lines) {
173
+ increment += lines - curTop;
174
+ }
175
+ articulation.setTextLine(state.top_text_line);
176
+ state.top_text_line += increment;
177
+ }
178
+ else if (articulation.getPosition() === BELOW) {
179
+ let noteLine = Math.max(lines - note.getLineNumber(), 0);
180
+ if (stemDirection === Stem.DOWN) {
181
+ noteLine += stemHeight;
182
+ }
183
+ let increment = getIncrement(articulation, state.text_line, BELOW);
184
+ const curBottom = noteLine + state.text_line + 0.5;
185
+ if (!articulation.articulation.between_lines && curBottom < lines) {
186
+ increment += lines - curBottom;
187
+ }
188
+ articulation.setTextLine(state.text_line);
189
+ state.text_line += increment;
190
+ }
191
+ });
192
+ const width = articulations
193
+ .map((articulation) => articulation.getWidth())
194
+ .reduce((maxWidth, articWidth) => Math.max(articWidth, maxWidth));
195
+ const overlap = Math.min(Math.max(width - maxGlyphWidth, 0), Math.max(width - (state.left_shift + state.right_shift), 0));
196
+ state.left_shift += overlap / 2;
197
+ state.right_shift += overlap / 2;
198
+ return true;
199
+ }
200
+ static easyScoreHook({ articulations }, note, builder) {
201
+ if (!articulations)
202
+ return;
203
+ const articNameToCode = {
204
+ staccato: 'a.',
205
+ tenuto: 'a-',
206
+ accent: 'a>',
207
+ };
208
+ articulations
209
+ .split(',')
210
+ .map((articString) => articString.trim().split('.'))
211
+ .map(([name, position]) => {
212
+ const artic = { type: articNameToCode[name] };
213
+ if (position)
214
+ artic.position = Modifier.PositionString[position];
215
+ return builder.getFactory().Articulation(artic);
216
+ })
217
+ .map((artic) => note.addModifier(artic, 0));
218
+ }
219
+ reset() {
220
+ this.articulation = Tables.articulationCodes(this.type);
221
+ const articulation = defined(this.articulation, 'ArgumentError', `Articulation not found: ${this.type}`);
222
+ const code = (this.position === ABOVE ? articulation.aboveCode : articulation.belowCode) || articulation.code;
223
+ this.glyph = new Glyph(code !== null && code !== void 0 ? code : '', this.render_options.font_scale);
224
+ this.setWidth(defined(this.glyph.getMetrics().width));
225
+ }
226
+ draw() {
227
+ const ctx = this.checkContext();
228
+ const note = this.checkAttachedNote();
229
+ this.setRendered();
230
+ const index = this.checkIndex();
231
+ const { position, glyph, text_line: textLine } = this;
232
+ const canSitBetweenLines = this.articulation.between_lines;
233
+ const stave = note.checkStave();
234
+ const staffSpace = stave.getSpacingBetweenLines();
235
+ const isTab = isTabNote(note);
236
+ const { x } = note.getModifierStartXY(position, index);
237
+ const shouldSitOutsideStaff = !canSitBetweenLines || isTab;
238
+ const initialOffset = getInitialOffset(note, position);
239
+ const padding = Tables.currentMusicFont().lookupMetric(`articulation.${glyph.getCode()}.padding`, 0);
240
+ let y = {
241
+ [ABOVE]: () => {
242
+ glyph.setOrigin(0.5, 1);
243
+ const y = getTopY(note, textLine) - (textLine + initialOffset) * staffSpace;
244
+ return shouldSitOutsideStaff ? Math.min(stave.getYForTopText(Articulation.INITIAL_OFFSET), y) : y;
245
+ },
246
+ [BELOW]: () => {
247
+ glyph.setOrigin(0.5, 0);
248
+ const y = getBottomY(note, textLine) + (textLine + initialOffset) * staffSpace;
249
+ return shouldSitOutsideStaff ? Math.max(stave.getYForBottomText(Articulation.INITIAL_OFFSET), y) : y;
250
+ },
251
+ }[position]();
252
+ if (!isTab) {
253
+ const offsetDirection = position === ABOVE ? -1 : +1;
254
+ const noteLine = note.getKeyProps()[index].line;
255
+ const distanceFromNote = (note.getYs()[index] - y) / staffSpace;
256
+ const articLine = distanceFromNote + Number(noteLine);
257
+ const snappedLine = snapLineToStaff(canSitBetweenLines, articLine, position, offsetDirection);
258
+ if (isWithinLines(snappedLine, position))
259
+ glyph.setOrigin(0.5, 0.5);
260
+ y += Math.abs(snappedLine - articLine) * staffSpace * offsetDirection + padding * offsetDirection;
261
+ }
262
+ L(`Rendering articulation at (x: ${x}, y: ${y})`);
263
+ glyph.render(ctx, x, y);
264
+ }
265
+ }
266
+ Articulation.DEBUG = false;
267
+ Articulation.INITIAL_OFFSET = -0.5;
@@ -0,0 +1,58 @@
1
+ import { Note } from './note.js';
2
+ import { Barline, BarlineType } from './stavebarline.js';
3
+ import { log } from './util.js';
4
+ function L(...args) {
5
+ if (BarNote.DEBUG)
6
+ log('Vex.Flow.BarNote', args);
7
+ }
8
+ export class BarNote extends Note {
9
+ constructor(type = BarlineType.SINGLE) {
10
+ super({ duration: 'b' });
11
+ this.metrics = {
12
+ widths: {},
13
+ };
14
+ const TYPE = BarlineType;
15
+ this.metrics.widths = {
16
+ [TYPE.SINGLE]: 8,
17
+ [TYPE.DOUBLE]: 12,
18
+ [TYPE.END]: 15,
19
+ [TYPE.REPEAT_BEGIN]: 14,
20
+ [TYPE.REPEAT_END]: 14,
21
+ [TYPE.REPEAT_BOTH]: 18,
22
+ [TYPE.NONE]: 0,
23
+ };
24
+ this.ignore_ticks = true;
25
+ this.setType(type);
26
+ }
27
+ static get CATEGORY() {
28
+ return "BarNote";
29
+ }
30
+ getType() {
31
+ return this.type;
32
+ }
33
+ setType(type) {
34
+ this.type = typeof type === 'string' ? Barline.typeString[type] : type;
35
+ this.setWidth(this.metrics.widths[this.type]);
36
+ return this;
37
+ }
38
+ addToModifierContext(mc) {
39
+ return this;
40
+ }
41
+ preFormat() {
42
+ this.preFormatted = true;
43
+ return this;
44
+ }
45
+ draw() {
46
+ const ctx = this.checkContext();
47
+ L('Rendering bar line at: ', this.getAbsoluteX());
48
+ if (this.style)
49
+ this.applyStyle(ctx);
50
+ const barline = new Barline(this.type);
51
+ barline.setX(this.getAbsoluteX());
52
+ barline.draw(this.checkStave());
53
+ if (this.style)
54
+ this.restoreStyle(ctx);
55
+ this.setRendered();
56
+ }
57
+ }
58
+ BarNote.DEBUG = false;