chordsheetjs 8.6.0 → 9.0.0

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 (2) hide show
  1. package/README.md +73 -1
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -471,12 +471,16 @@ Inherits from [ChordSheetParser](#ChordSheetParser)</p></dd>
471
471
  <dd><p>Copyright meta directive. See https://www.chordpro.org/chordpro/directives-copyright/</p></dd>
472
472
  <dt><a href="#DURATION">DURATION</a> : <code>string</code></dt>
473
473
  <dd><p>Duration meta directive. See https://www.chordpro.org/chordpro/directives-duration/</p></dd>
474
+ <dt><a href="#END_OF_ABC">END_OF_ABC</a> : <code>string</code></dt>
475
+ <dd><p>End of ABC music notation section See https://chordpro.org/chordpro/directives-env_abc/</p></dd>
474
476
  <dt><a href="#END_OF_BRIDGE">END_OF_BRIDGE</a> : <code>string</code></dt>
475
477
  <dd><p>End of bridge directive. See https://chordpro.org/chordpro/directives-env_bridge/</p></dd>
476
478
  <dt><a href="#END_OF_CHORUS">END_OF_CHORUS</a> : <code>string</code></dt>
477
479
  <dd><p>End of chorus directive. See https://www.chordpro.org/chordpro/directives-env_chorus/</p></dd>
478
480
  <dt><a href="#END_OF_GRID">END_OF_GRID</a> : <code>string</code></dt>
479
481
  <dd><p>End of grid directive. See https://www.chordpro.org/chordpro/directives-env_grid/</p></dd>
482
+ <dt><a href="#END_OF_LY">END_OF_LY</a> : <code>string</code></dt>
483
+ <dd><p>End of Lilypond music notation section See https://chordpro.org/chordpro/directives-env_ly/</p></dd>
480
484
  <dt><a href="#END_OF_TAB">END_OF_TAB</a> : <code>string</code></dt>
481
485
  <dd><p>End of tab directive. See https://www.chordpro.org/chordpro/directives-env_tab/</p></dd>
482
486
  <dt><a href="#END_OF_VERSE">END_OF_VERSE</a> : <code>string</code></dt>
@@ -490,12 +494,16 @@ See https://www.chordpro.org/chordpro/directives-key/</p></dd>
490
494
  <dd><p>Lyricist meta directive. See https://www.chordpro.org/chordpro/directives-lyricist/</p></dd>
491
495
  <dt><a href="#SORTTITLE">SORTTITLE</a> : <code>string</code></dt>
492
496
  <dd><p>Sorttitle meta directive. See https://chordpro.org/chordpro/directives-sorttitle/</p></dd>
497
+ <dt><a href="#START_OF_ABC">START_OF_ABC</a> : <code>string</code></dt>
498
+ <dd><p>Start of ABC music notation section See https://chordpro.org/chordpro/directives-env_abc/</p></dd>
493
499
  <dt><a href="#START_OF_BRIDGE">START_OF_BRIDGE</a> : <code>string</code></dt>
494
500
  <dd><p>Start of bridge directive. See https://chordpro.org/chordpro/directives-env_bridge/</p></dd>
495
501
  <dt><a href="#START_OF_CHORUS">START_OF_CHORUS</a> : <code>string</code></dt>
496
502
  <dd><p>Start of chorus directive. See https://www.chordpro.org/chordpro/directives-env_chorus/</p></dd>
497
503
  <dt><a href="#START_OF_GRID">START_OF_GRID</a> : <code>string</code></dt>
498
504
  <dd><p>Start of grid directive. See https://www.chordpro.org/chordpro/directives-env_grid/</p></dd>
505
+ <dt><a href="#START_OF_LY">START_OF_LY</a> : <code>string</code></dt>
506
+ <dd><p>Start of Lilypond music notation section See https://chordpro.org/chordpro/directives-env_ly/</p></dd>
499
507
  <dt><a href="#START_OF_TAB">START_OF_TAB</a> : <code>string</code></dt>
500
508
  <dd><p>Start of tab directive. See https://www.chordpro.org/chordpro/directives-env_tab/</p></dd>
501
509
  <dt><a href="#START_OF_VERSE">START_OF_VERSE</a> : <code>string</code></dt>
@@ -552,6 +560,10 @@ Possible values are 'solfege', 'symbol', 'numeral' and 'number'</p></dd>
552
560
  <dd><p>Used to mark a paragraph as tab</p></dd>
553
561
  <dt><a href="#VERSE">VERSE</a> : <code>string</code></dt>
554
562
  <dd><p>Used to mark a paragraph as verse</p></dd>
563
+ <dt><a href="#LILYPOND">LILYPOND</a> : <code>string</code></dt>
564
+ <dd><p>Used to mark a section as Lilypond notation</p></dd>
565
+ <dt><a href="#ABC">ABC</a> : <code>string</code></dt>
566
+ <dd><p>Used to mark a section as ABC music notation</p></dd>
555
567
  </dl>
556
568
 
557
569
  ## Functions
@@ -786,9 +798,25 @@ else it returns an array of strings.</p>
786
798
  **Kind**: global class
787
799
 
788
800
  * [Paragraph](#Paragraph)
801
+ * [.contents](#Paragraph+contents) ⇒ <code>string</code>
802
+ * [.label](#Paragraph+label) ⇒ <code>string</code> \| <code>null</code>
789
803
  * [.type](#Paragraph+type) ⇒ <code>string</code>
804
+ * [.isLiteral()](#Paragraph+isLiteral) ⇒ <code>boolean</code>
790
805
  * [.hasRenderableItems()](#Paragraph+hasRenderableItems) ⇒ <code>boolean</code>
791
806
 
807
+ <a name="Paragraph+contents"></a>
808
+
809
+ ### paragraph.contents ⇒ <code>string</code>
810
+ <p>Returns the paragraph contents as one string where lines are separated by newlines</p>
811
+
812
+ **Kind**: instance property of [<code>Paragraph</code>](#Paragraph)
813
+ <a name="Paragraph+label"></a>
814
+
815
+ ### paragraph.label ⇒ <code>string</code> \| <code>null</code>
816
+ <p>Returns the label of the paragraph. The label is the value of the first section delimiter tag
817
+ in the first line.</p>
818
+
819
+ **Kind**: instance property of [<code>Paragraph</code>](#Paragraph)
792
820
  <a name="Paragraph+type"></a>
793
821
 
794
822
  ### paragraph.type ⇒ <code>string</code>
@@ -796,6 +824,14 @@ else it returns an array of strings.</p>
796
824
  If not, it returns [INDETERMINATE](#INDETERMINATE)</p>
797
825
 
798
826
  **Kind**: instance property of [<code>Paragraph</code>](#Paragraph)
827
+ <a name="Paragraph+isLiteral"></a>
828
+
829
+ ### paragraph.isLiteral() ⇒ <code>boolean</code>
830
+ <p>Indicates whether the paragraph only contains literals. If true, [contents](contents) can be used to retrieve
831
+ the paragraph contents as one string where lines are separated by newlines.</p>
832
+
833
+ **Kind**: instance method of [<code>Paragraph</code>](#Paragraph)
834
+ **See**: [contents](contents)
799
835
  <a name="Paragraph+hasRenderableItems"></a>
800
836
 
801
837
  ### paragraph.hasRenderableItems() ⇒ <code>boolean</code>
@@ -862,7 +898,7 @@ if you want to skip the &quot;header lines&quot;: the lines that only contain me
862
898
  <a name="Song+expandedBodyParagraphs"></a>
863
899
 
864
900
  ### song.expandedBodyParagraphs : [<code>Array.&lt;Paragraph&gt;</code>](#Paragraph)
865
- <p>The body paragraphs of the song, with any <code>{chorus}</code> tag expanded into the targetted chorus</p>
901
+ <p>The body paragraphs of the song, with any <code>{chorus}</code> tag expanded into the targeted chorus</p>
866
902
 
867
903
  **Kind**: instance property of [<code>Song</code>](#Song)
868
904
  <a name="Song+clone"></a>
@@ -1771,6 +1807,12 @@ Can be deserialized using [deserialize](deserialize)</p>
1771
1807
  ## DURATION : <code>string</code>
1772
1808
  <p>Duration meta directive. See https://www.chordpro.org/chordpro/directives-duration/</p>
1773
1809
 
1810
+ **Kind**: global constant
1811
+ <a name="END_OF_ABC"></a>
1812
+
1813
+ ## END\_OF\_ABC : <code>string</code>
1814
+ <p>End of ABC music notation section See https://chordpro.org/chordpro/directives-env_abc/</p>
1815
+
1774
1816
  **Kind**: global constant
1775
1817
  <a name="END_OF_BRIDGE"></a>
1776
1818
 
@@ -1789,6 +1831,12 @@ Can be deserialized using [deserialize](deserialize)</p>
1789
1831
  ## END\_OF\_GRID : <code>string</code>
1790
1832
  <p>End of grid directive. See https://www.chordpro.org/chordpro/directives-env_grid/</p>
1791
1833
 
1834
+ **Kind**: global constant
1835
+ <a name="END_OF_LY"></a>
1836
+
1837
+ ## END\_OF\_LY : <code>string</code>
1838
+ <p>End of Lilypond music notation section See https://chordpro.org/chordpro/directives-env_ly/</p>
1839
+
1792
1840
  **Kind**: global constant
1793
1841
  <a name="END_OF_TAB"></a>
1794
1842
 
@@ -1826,6 +1874,12 @@ See https://www.chordpro.org/chordpro/directives-key/</p>
1826
1874
  ## SORTTITLE : <code>string</code>
1827
1875
  <p>Sorttitle meta directive. See https://chordpro.org/chordpro/directives-sorttitle/</p>
1828
1876
 
1877
+ **Kind**: global constant
1878
+ <a name="START_OF_ABC"></a>
1879
+
1880
+ ## START\_OF\_ABC : <code>string</code>
1881
+ <p>Start of ABC music notation section See https://chordpro.org/chordpro/directives-env_abc/</p>
1882
+
1829
1883
  **Kind**: global constant
1830
1884
  <a name="START_OF_BRIDGE"></a>
1831
1885
 
@@ -1844,6 +1898,12 @@ See https://www.chordpro.org/chordpro/directives-key/</p>
1844
1898
  ## START\_OF\_GRID : <code>string</code>
1845
1899
  <p>Start of grid directive. See https://www.chordpro.org/chordpro/directives-env_grid/</p>
1846
1900
 
1901
+ **Kind**: global constant
1902
+ <a name="START_OF_LY"></a>
1903
+
1904
+ ## START\_OF\_LY : <code>string</code>
1905
+ <p>Start of Lilypond music notation section See https://chordpro.org/chordpro/directives-env_ly/</p>
1906
+
1847
1907
  **Kind**: global constant
1848
1908
  <a name="START_OF_TAB"></a>
1849
1909
 
@@ -2009,6 +2069,18 @@ Possible values are 'solfege', 'symbol', 'numeral' and 'number'</p>
2009
2069
  ## VERSE : <code>string</code>
2010
2070
  <p>Used to mark a paragraph as verse</p>
2011
2071
 
2072
+ **Kind**: global constant
2073
+ <a name="LILYPOND"></a>
2074
+
2075
+ ## LILYPOND : <code>string</code>
2076
+ <p>Used to mark a section as Lilypond notation</p>
2077
+
2078
+ **Kind**: global constant
2079
+ <a name="ABC"></a>
2080
+
2081
+ ## ABC : <code>string</code>
2082
+ <p>Used to mark a section as ABC music notation</p>
2083
+
2012
2084
  **Kind**: global constant
2013
2085
  <a name="scopedCss"></a>
2014
2086
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "chordsheetjs",
3
3
  "author": "Martijn Versluis",
4
- "version": "8.6.0",
4
+ "version": "9.0.0",
5
5
  "description": "A JavaScript library for parsing and formatting chord sheets",
6
6
  "source": "src/index.ts",
7
7
  "main": "lib/index.js",