@barmark/render 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -6,6 +6,17 @@ package uses [semantic versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-11-02
+
+Power chords in the numerals views. Requires `barmark` 0.7.0.
+
+### Changed
+
+- **A power chord's 5 is raised in the numerals views:** D5 in D shows as
+  1⁵ (Nashville) and I⁵ (Roman), G5(7) as 4⁵⁽⁷⁾. On the baseline the
+  Nashville 5 joined the number and read as 15. Chord names are
+  unchanged (D5).
+
 ## [0.6.0] - 2026-11-02
 
 Charts that scroll instead of wrapping. barmark.dev's home page uses it.
@@ -179,7 +190,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.6.0...HEAD
+[Unreleased]: https://github.com/kevinpeckham/barmark/compare/render-v0.7.0...HEAD
+[0.7.0]: https://github.com/kevinpeckham/barmark/compare/render-v0.6.0...render-v0.7.0
 [0.6.0]: https://github.com/kevinpeckham/barmark/compare/render-v0.5.0...render-v0.6.0
 [0.5.0]: https://github.com/kevinpeckham/barmark/compare/render-v0.4.0...render-v0.5.0
 [0.4.0]: https://github.com/kevinpeckham/barmark/compare/render-v0.3.0...render-v0.4.0

package/README.md

@@ -88,10 +88,11 @@ played in, so a modulation renumbers from its next bar. Degrees count
 from the key's tonic against the major scale, in every mode: in `key:
 Am`, Am is 1m and C is ♭3. Nashville keeps the chord's quality and
 superscript after the number (Bm7 in D is 6m⁷, D/F♯ is 1/3); Roman
-shows minor and diminished in lower case (ii, vii°, ♭VII). A bar with
-no key, note sets, N.C., `?` and `--` look as they always do, and a
-screen reader hears both: "bar 5: five, A seven". Numbered chords carry
-`data-numeral`. It's a view: the music and bar numbers don't change.
+shows minor and diminished in lower case (ii, vii°, ♭VII). Both raise a
+power chord's 5 into the superscript (D5 in D is 1⁵ and I⁵, never 15).
+A bar with no key, note sets, N.C., `?` and `--` look as they always
+do, and a screen reader hears both: "bar 5: five, A seven". Numbered
+chords carry `data-numeral`. It's a view: the music and bar numbers don't change.
 
 ### Spoken names
 

package/dist/chord.d.ts

@@ -17,7 +17,8 @@ export declare const NUMERALS: readonly Numerals[];
 /**
  * A chord as its degree in `key`: Nashville keeps the chord's quality and
  * superscript after the number; Roman shows minor and diminished in lower
- * case. A slash bass is a number in both. Null if the root has no degree.
+ * case. Both raise a power chord's 5 into the superscript (1⁵, I⁵). A
+ * slash bass is a number in both. Null if the root has no degree.
  */
 export declare function typesetNumeral(parts: ChordParts, key: Key, style: Numerals): ChordPieces | null;
 /** A note set's label (`E1`, `F#`) as name and octave. */

package/dist/chord.js

@@ -27,21 +27,25 @@ const ROMAN_QUALITY = {
     m: "",
     dim: "°",
     aug: "+",
-    "5": "5",
+    // Raised into the superscript with the other numerals (raisePower).
+    "5": "",
 };
+/** A power chord's 5 goes up with the superscript: on the baseline it joins the number (1 and 5 read as 15). */
+const raisePower = (p) => p.quality === "5" ? { ...p, quality: "", superscript: `5${p.superscript}` } : p;
 const accidentals = (alter) => (alter < 0 ? "b" : "#").repeat(Math.abs(alter));
 /** `{ degree: 7, alter: -1 }` → `♭7`. */
 const degreeText = (d) => glyphs(`${accidentals(d.alter)}${d.degree}`);
 /**
  * A chord as its degree in `key`: Nashville keeps the chord's quality and
  * superscript after the number; Roman shows minor and diminished in lower
- * case. A slash bass is a number in both. Null if the root has no degree.
+ * case. Both raise a power chord's 5 into the superscript (1⁵, I⁵). A
+ * slash bass is a number in both. Null if the root has no degree.
  */
 export function typesetNumeral(parts, key, style) {
     const degree = degreeOf(parts.root, key);
     if (!degree)
         return null;
-    const pieces = typesetChord(parts);
+    const pieces = raisePower(typesetChord(parts));
     const bass = parts.bass ? degreeOf(parts.bass, key) : null;
     const withBass = { ...pieces, bass: bass ? degreeText(bass) : pieces.bass };
     if (style === "nashville")

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@barmark/render",
-	"version": "0.6.0",
+	"version": "0.7.0",
 	"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": {
@@ -47,7 +47,7 @@
 		"url": "https://github.com/kevinpeckham/barmark/issues"
 	},
 	"dependencies": {
-		"barmark": "^0.6.0"
+		"barmark": "^0.7.0"
 	},
 	"scripts": {
 		"build": "rm -rf dist && tsc -p tsconfig.build.json",