Make every docs example parse, and add a test that keeps it that way

docs/.claude/settings.local.json

@@ -0,0 +1,15 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pnpm build:*)",
+      "Bash(npm info:*)",
+      "Bash(cat:*)",
+      "Bash(ls:*)",
+      "Bash(grep:*)",
+      "Bash(pnpm run buildbase:*)",
+      "Bash(xargs basename:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

docs/content/api/integration-guide/index.html

@@ -83,7 +83,7 @@ <h2 id="cdn">CDN / Vanilla HTML</h2>
 \cycle("|4|2|2|")
 Sw: S R G M P D N S.
 Sh: sa ri ga ma pa dha ni sa
-    </notation>
+</notation>
   </div>
 </div>
 

docs/content/api/integration-guide/nodejs/index.html

@@ -86,11 +86,11 @@ <h2>Accessing Notation Structure</h2>
 <notation showSource="true" caption="Multi-line Composition">
 \cycle("|4|2|2|")
 \line("Pallavi")
-Sw: S , R , | G , M , | P , D , | N , S. , ||
-Sh: ni , nnu , | ko , ri , | va , ra , | nam , ma , ||
+Sw: S , R , G , M , P , D , N , S. ,
+Sh: ni , nnu , ko , ri , va , ra , nam , ma ,
 \line("Anupallavi")
-Sw: S. , N , | D , P , | M , G , | R , S , ||
-Sh: en , na , | gu , ru , | sva , mi , | ra , ya , ||
+Sw: S. , N , D , P , M , G , R , S ,
+Sh: en , na , gu , ru , sva , mi , ra , ya ,
 </notation>
 
 <h2>Validation</h2>

docs/content/api/integration-guide/react/index.html

@@ -73,7 +73,7 @@ <h2>Basic NotationViewer Component</h2>
 \cycle("|4|2|2|")
 Sw: S R G M P D N S.
 Sh: sa ri ga ma pa dha ni sa
-    </notation>
+</notation>
   </div>
 </div>
 
@@ -156,7 +156,7 @@ <h2>Component with Source Display and Editing</h2>
 \line("Pallavi")
 Sw: S , R , G , M , P , D , N , S. ,
 Sh: ni , nnu , ko , ri , va , ra , nam , ma ,
-    </notation>
+</notation>
   </div>
 </div>
 

docs/content/api/integration-guide/vue/index.html

@@ -79,7 +79,7 @@ <h2>Basic NotationViewer Component</h2>
 \cycle("|4|2|2|")
 Sw: S R G M P D N S.
 Sh: sa ri ga ma pa dha ni sa
-    </notation>
+</notation>
   </div>
 </div>
 
@@ -191,7 +191,7 @@ <h2>Component with Source Display and Editing</h2>
 \line("Pallavi")
 Sw: S , R , G , M , P , D , N , S. ,
 Sh: ni , nnu , ko , ri , va , ra , nam , ma ,
-    </notation>
+</notation>
   </div>
 </div>
 

docs/content/api/integration-guide/web-components/index.html

@@ -189,7 +189,7 @@ <h2>Advanced: External Source</h2>
 \beatDuration(4)
 \line("Pallavi")
 Sw: S , R , G , M , P , D , N , S. ,
-Sh: ni , nnu , ko , ri , va , ra , nam , ma , 
+Sh: ni , nnu , ko , ri , va , ra , nam , ma ,
 </notation>
 
 <h2>Interactive Features</h2>

docs/content/api/styling/index.html

@@ -156,7 +156,7 @@ <h4 style="margin-top: 0; color: #023e8a;">Ocean Theme</h4>
 \cycle("|4|2|2|")
 \beatDuration(4)
 Sw: S R G M , P D , N S.
-  </notation>
+</notation>
 </div>
 
 <div class="theme-forest">
@@ -165,7 +165,7 @@ <h4 style="margin-top: 0; color: #1b4332;">Forest Theme</h4>
 \cycle("|4|2|2|")
 \beatDuration(4)
 Sw: S R G M , P D , N S.
-  </notation>
+</notation>
 </div>
 
 <div class="theme-sunset">
@@ -174,7 +174,7 @@ <h4 style="margin-top: 0; color: #7b2cbf;">Sunset Theme</h4>
 \cycle("|4|2|2|")
 \beatDuration(4)
 Sw: S R G M , P D , N S.
-  </notation>
+</notation>
 </div>
 
 <h3>CSS for Scoped Themes</h3>

docs/content/demos/playgrounds/model-events/index.html

@@ -94,7 +94,7 @@ <h2>Notation Syntax</h2>
   <tr><td><code>S R G M</code></td><td>Individual notes</td></tr>
   <tr><td><code>S.</code> or <code>S'</code></td><td>Higher octave</td></tr>
   <tr><td><code>.S</code> or <code>S,</code></td><td>Lower octave</td></tr>
-  <tr><td><code>,</code> or <code>_</code></td><td>Space/silence</td></tr>
+  <tr><td><code>,</code></td><td>Space/silence</td></tr>
   <tr><td><code>[ G M P ]</code></td><td>Group (atoms share duration)</td></tr>
   <tr><td><code>2 S</code></td><td>Duration prefix (S has duration 2)</td></tr>
 </table>

docs/content/examples/basic-varnam/index.html

@@ -163,7 +163,7 @@ <h2>Tips for Varnam Notation</h2>
 
 <ul>
   <li>Always align swaras and sahitya on the same beat</li>
-  <li>Use underscores (<code>_</code>) for sustained notes or pauses</li>
+  <li>Use commas (<code>,</code>) for sustained notes or pauses</li>
   <li>Use <code>\line()</code> to separate sections clearly</li>
   <li>Mark speed changes in muktayi swarams</li>
 </ul>

docs/content/examples/complex-gamakas/index.html

@@ -94,8 +94,8 @@ <h2>Combining with Speed Changes</h2>
 <h2>Practical Tips</h2>
 
 <ul>
-  <li>Use <code>kampitam</code> for sustained oscillating notes</li>
-  <li>Use <code>jaru</code> for smooth glides between notes</li>
+  <li>Use <code>~</code> before a note for kampitam, the sustained oscillation</li>
+  <li>Use <code>~/</code> and <code>~\</code> for jaaru, the glide up into or down into a note</li>
   <li>Use <code>~</code> for quick ornamental touches</li>
   <li>Study raga-specific gamaka patterns</li>
   <li>Listen to masters to understand proper gamaka application</li>

docs/content/examples/organizing-compositions/index.html

@@ -14,16 +14,16 @@ <h2>Using Lines to Separate Sections</h2>
 \beatDuration(4)
 
 \line("Pallavi")
-Sw: S R G M , P D N S. , ___ ___ , ___ ___ |
-Sh: sa ri ga ma , pa dha ni sa , ___ ___ , ___ ___ ||
+Sw: S R G M , P D N S. , , , , , , , , , , , , , ,
+Sh: sa ri ga ma , pa dha ni sa , , , , , , , , , , , , , ,
 
 \line("Anupallavi")
-Sw: S. R. G. M. , P. D. N. S.. , ___ ___ , ___ ___ |
-Sh: sa ri ga ma , pa dha ni sa , ___ ___ , ___ ___ ||
+Sw: S. R. G. M. , P. D. N. S.. , , , , , , , , , , , , , ,
+Sh: sa ri ga ma , pa dha ni sa , , , , , , , , , , , , , ,
 
 \line("Charanam")
-Sw: P D S. R. , S. D P M , G M P D , S. ___ |
-Sh: pa dha sa ri , sa dha pa ma , ga ma pa dha , sa ___ ||
+Sw: P D S. R. , S. D P M , G M P D , S. , , ,
+Sh: pa dha sa ri , sa dha pa ma , ga ma pa dha , sa , , ,
 </notation>
 
 <h2>Separating Swaras and Sahitya</h2>
@@ -35,10 +35,10 @@ <h2>Separating Swaras and Sahitya</h2>
 \beatDuration(4)
 
 \line("Pallavi - Swaras")
-Sw: S R G M , P M G R , S R G M , P ___ ___ ___ |
+Sw: S R G M , P M G R , S R G M , P , , , , , , , , ,
 
 \line("Pallavi - Sahitya")
-Sh: nin nu ko ri , va ra da nun , nu ko ri , va ___ ___ ___ ||
+Sh: nin nu ko ri , va ra da nun , nu ko ri , va , , , , , , , , ,
 </notation>
 
 <h2>Multi-Speed Sections</h2>
@@ -50,13 +50,13 @@ <h2>Multi-Speed Sections</h2>
 \beatDuration(4)
 
 \line("Muktayi Swaram - 1st Speed")
-S R G M , P D N S. , ___ ___ , ___ ___ |
+S R G M , P D N S. , , , , , , , , , , , , , ,
 
 \line("Muktayi Swaram - 2nd Speed")
-SR GM PD NS. , R.S. DP MG RS , ___ ___ ___ ___ , ___ ___ ___ ___ |
+SR GM PD NS. , R.S. DP MG RS , , , , , , , , , , , , , , , , , , , , , , , , , ,
 
 \line("Muktayi Swaram - 3rd Speed")
-SRG GMP PDN NS.R. , R.S.D DPN PMG GRS , ___ ___ ___ ___ , ___ ___ ___ ___ |
+SRG GMP PDN NS.R. , R.S.D DPN PMG GRS , , , , , , , , , , , , , , , , , , , , , , , , , ,
 </notation>
 
 <h2>Long Kriti Structure</h2>
@@ -68,35 +68,37 @@ <h2>Long Kriti Structure</h2>
 \beatDuration(4)
 
 \line("==== PALLAVI ====")
-Sw: S R G M , P D N S. , ___ ___ , ___ ___ |
-Sh: bro va bha ra ma , moo la ra ma chan , dra ___ , ___ ___ ||
+Sw: S R G M , P D N S. , , , , , , , , , , , , , ,
+Sh: bro va bha ra ma , moo la ra ma chan , dra , , , , , , , , , ,
 
 \line("==== ANUPALLAVI ====")
-Sw: S. R. G. M. , P. D. N. S.. , ___ ___ , ___ ___ |
-Sh: de va de va , ja ya ja ya , ___ ___ , ___ ___ ||
+Sw: S. R. G. M. , P. D. N. S.. , , , , , , , , , , , , , ,
+Sh: de va de va , ja ya ja ya , , , , , , , , , , , , , ,
 
 \line("==== CHARANAM 1 ====")
-Sw: P D S. R. , S. D P M , G R S ___ , ___ ___ ___ ___ |
-Sh: ka ru na ni dhi , ra ma bha dra , nin ne ___ , ___ ___ ___ ___ ||
+Sw: P D S. R. , S. D P M , G R S , , , , , , , , , , , , , , , ,
+Sh: ka ru na ni dhi , ra ma bha dra , nin ne , , , , , , , , , , , , , , , ,
 
 \line("==== CHARANAM 2 ====")
-Sw: S R G M , P M G R , S R G M , P ___ ___ ___ |
-Sh: sa da sa dhi ya , tya ga ra ja , vi nu ta , ra ___ ___ ___ ||
+Sw: S R G M , P M G R , S R G M , P , , , , , , , , ,
+Sh: sa da sa dhi ya , tya ga ra ja , vi nu ta , ra , , , , , , , , ,
 </notation>
 
 <h2>Using Comments for Annotations</h2>
 
-<p>Add performance notes or reminders:</p>
+<p>Anything after <code>//</code> on a line is ignored by the parser, so performance notes and
+reminders can sit next to the notation they describe rather than in a line title:</p>
 
 <notation id="comments" showSource="true" caption="Using Comments">
 \cycle("|4|2|2|")
 \beatDuration(4)
 
-\line("Pallavi - Slow tempo, emphasize gamakas")
-Sw: S (R~G) M P , (P~D) N S. , ___ ___ , ___ ___ |
-Sh: nin nu ko ri , va ra da , ___ ___ , ___ ___ ||
+// Slow tempo here, let the gamakas breathe
+\line("Pallavi")
+Sw: S [~ R G] M P , [~ P D] N S. , , , , , , , , , , , , , ,
+Sh: nin nu ko ri , va ra da , , , , , , , , , , , , , ,
 
-\line("Repeat pallavi 2x before anupallavi")
+// Repeat the pallavi twice before moving to the anupallavi
 </notation>
 
 <h2>Organizing Repetitions</h2>
@@ -108,10 +110,10 @@ <h2>Organizing Repetitions</h2>
 \beatDuration(4)
 
 \line("Pallavi [Repeat 2x]")
-Sw: S R G M , P D N S. , ___ ___ , ___ ___ ||
+Sw: S R G M , P D N S. , , , , , , , , , , , , , ,
 
 \line("Anupallavi")
-Sw: S. R. G. M. , P. D. N. S.. , ___ ___ , ___ ___ ||
+Sw: S. R. G. M. , P. D. N. S.. , , , , , , , , , , , , , ,
 
 \line("[Return to Pallavi]")
 </notation>
@@ -125,10 +127,10 @@ <h2>Breaking Long Phrases</h2>
 \beatDuration(4)
 
 \line("Extended Swaram - Part 1")
-SR GM PD NS. , R.S. DP MG RS , SR GM PD NS. , R.S. DP MG RS |
+SR GM PD NS. , R.S. DP MG RS , SR GM PD NS. , R.S. DP MG RS
 
 \line("Extended Swaram - Part 2")
-S.R. G.M. P.D. N.S.. , R..S.. D..N.. P..D.. M..P.. , G..M.. R..G.. S..R.. ___ , ___ ___ ___ ___ |
+S.R. G.M. P.D. N.S.. , R..S.. D..N.. P..D.. M..P.. , G..M.. R..G.. S..R.. , , , , , , , , , , , , , , , ,
 </notation>
 
 <h2>Organizing by Tala Avartanams</h2>
@@ -140,13 +142,13 @@ <h2>Organizing by Tala Avartanams</h2>
 \beatDuration(4)
 
 \line("Avartanam 1")
-S R G M , P D N S. , ___ ___ , ___ ___ |
+S R G M , P D N S. , , , , , , , , , , , , , ,
 
 \line("Avartanam 2")
-S. R. G. M. , P. D. N. S.. , ___ ___ , ___ ___ |
+S. R. G. M. , P. D. N. S.. , , , , , , , , , , , , , ,
 
 \line("Avartanam 3")
-S.. D.. N.. S.. , P. M. G. R. , S. ___ ___ , ___ ___ ___ ||
+S.. D.. N.. S.. , P. M. G. R. , S. , , , , , , , , , , , , , , , ,
 </notation>
 
 <h2>Best Practices</h2>
@@ -156,7 +158,7 @@ <h2>Best Practices</h2>
   <li><strong>Visual separation</strong> - Use <code>\line()</code> liberally to separate sections</li>
   <li><strong>Alignment</strong> - Keep swaras and sahitya aligned on the same beats</li>
   <li><strong>Speed markers</strong> - Always label speed changes (1st, 2nd, 3rd speed)</li>
-  <li><strong>Tala markers</strong> - Use <code>|</code> and <code>||</code> to mark avartanam boundaries</li>
+  <li><strong>Tala markers</strong> - Drawn for you from the cycle, one line at the end of each bar and a double line at the end of the avartanam</li>
   <li><strong>Whitespace</strong> - Don't be afraid of empty space for readability</li>
   <li><strong>Comments</strong> - Add performance notes where helpful</li>
   <li><strong>Logical grouping</strong> - Group related phrases together</li>
@@ -167,7 +169,6 @@ <h2>Template for a Complete Composition</h2>
 <notation id="template" showSource="true" caption="Composition Template">
 \cycle("|4|2|2|")
 \beatDuration(4)
-\accidentals()  // Add accidentals if needed
 
 \line("==== PALLAVI ====")
 Sw: // Add swaras