@barmark/render 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -6,6 +6,18 @@ package uses [semantic versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.9.1] - 2026-11-03
+
+### Fixed
+
+- **Bar numbers count the bars as written** (issue #92), each once, as a
+  band counts them and as `PlayedBar.written` gives them. Before, the
+  margin counted played bars, so a second ending or anything after a
+  repeat or a jump numbered past the printed score. A replayed section
+  now shows the numbers it was written with; the coda after a
+  `D.S. al Coda`, and bars after an open repeat, are numbered instead
+  of left blank. Screen readers hear the same numbers.
+
 ## [0.9.0] - 2026-11-03
 
 ### Added
@@ -256,7 +268,8 @@ that needs no script or as the `<barmark-chart>` web component. Requires
   zoom without sideways scrolling, the element renders and re-renders, and
   a screen reader hears "bar 9: D". Run them with `bun run test:browser`.
 
-[Unreleased]: https://github.com/kevinpeckham/barmark/compare/render-v0.9.0...HEAD
+[Unreleased]: https://github.com/kevinpeckham/barmark/compare/render-v0.9.1...HEAD
+[0.9.1]: https://github.com/kevinpeckham/barmark/compare/render-v0.9.0...render-v0.9.1
 [0.9.0]: https://github.com/kevinpeckham/barmark/compare/render-v0.8.0...render-v0.9.0
 [0.8.0]: https://github.com/kevinpeckham/barmark/compare/render-v0.7.3...render-v0.8.0
 [0.7.3]: https://github.com/kevinpeckham/barmark/compare/render-v0.7.2...render-v0.7.3

package/README.md

@@ -178,8 +178,10 @@ At the default size chords are 16px and no label is under 12px.
 
 Chords appear in their canonical form whatever the author typed (`Cø`
 shows as Cm⁷(♭5)). `%` is drawn as the bar it copies; a replayed section
-is drawn in full with its own bar numbers, and its own lyrics replace the
-written section's. A line with an error shows as written, underlined,
+is drawn in full, and its own lyrics replace the written section's. Bar
+numbers count the bars as written, each once, as a band counts them: a
+repeat, an ending, a jump or a replay doesn't move them, so a replayed
+section shows the numbers it was written with. A line with an error shows as written, underlined,
 with its message. `layoutChart(text)` returns all of this as data, if
 you want to draw it yourself.
 

package/dist/model.js

@@ -13,7 +13,6 @@ export function layoutChart(text, options = {}) {
         parse,
         source: text.split(/\r?\n/),
         errors: errorsByLine(parse),
-        lastKnownBar: lastKnownBar(parse.events),
         written: new Map(groups.flatMap((g) => (g.heading ? [[g.heading.line, g]] : []))),
     };
     const blocks = groups.map((g) => layoutGroup(g, ctx));
@@ -44,27 +43,6 @@ function errorsByLine(parse) {
     }
     return errors;
 }
-/** The count of bars up to the end of the first open repeat (all of them if there is none). */
-function lastKnownBar(events) {
-    let count = 0;
-    const countBars = (es) => {
-        for (const e of es) {
-            if (e.kind === "bar")
-                count++;
-            else if (e.kind === "open")
-                countBars(e.events);
-        }
-    };
-    for (const e of events) {
-        if (e.kind === "open") {
-            countBars(e.events);
-            return count;
-        }
-        if (e.kind === "bar")
-            count++;
-    }
-    return Number.POSITIVE_INFINITY;
-}
 /** The title line, and the directives before any other content, form the header. */
 function splitHeader(lines) {
     const header = {};
@@ -226,11 +204,11 @@ function layoutRow(l, played, previous, ctx) {
             prev = model;
         cells.push(model);
     }
-    const firstIndex = played[0]?.index;
     return {
         kind: "row",
         line: l.line,
-        barNumber: firstIndex !== undefined && firstIndex <= ctx.lastKnownBar ? firstIndex : null,
+        // Numbered as written, as a band counts (issue #92): repeats, endings, jumps and replays don't move it.
+        barNumber: (played[0] ?? written[0])?.written ?? null,
         opens: l.opens,
         closes: l.closes,
         repeat: l.repeat,

package/dist/types.d.ts

@@ -25,7 +25,7 @@ export type SectionBlock = {
 export type BlockItem = {
     kind: "row";
     line: number;
-    /** The play-order number of the row's first bar on its first pass. */
+    /** The written number of the row's first bar (`PlayedBar.written`); a replay shows its section's numbers. Null for a row with no bar. */
     barNumber: number | null;
     opens: boolean;
     closes: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@barmark/render",
-	"version": "0.9.0",
+	"version": "0.9.1",
 	"description": "Render barmark chord charts as a clean, accessible bar grid: HTML with Declarative Shadow DOM, or the <barmark-chart> web component.",
 	"type": "module",
 	"exports": {