@real-music-packages/web-core 0.24.0 → 0.24.1

package/dist/scene/index.d.ts

@@ -1840,6 +1840,9 @@ interface ScaleHighlightProps {
     label?: boolean;
     /** Override the label text. Default `${root} ${PrettyScale}`. */
     labelText?: string;
+    /** Label vertical position as a fraction of H. Default near the safe-box top.
+     *  Set this when the host already draws a top title so the name doesn't collide. */
+    labelCenterFrac?: number;
 }
 declare const scaleHighlightFactory: LayerFactory<ScaleHighlightProps>;
 

package/dist/scene/index.js

@@ -4005,6 +4005,7 @@ function scaleHighlightLayer() {
   let alpha = 0.55;
   let label = true;
   let labelTextProp;
+  let labelCenterFrac;
   return {
     key: "scale-highlight",
     init(_ctx, props) {
@@ -4015,6 +4016,7 @@ function scaleHighlightLayer() {
       alpha = props.alpha ?? 0.55;
       label = props.label ?? true;
       labelTextProp = props.labelText;
+      labelCenterFrac = props.labelCenterFrac;
     },
     draw(ctx, _tMs) {
       const c = ctx.ctx2d;
@@ -4045,8 +4047,9 @@ function scaleHighlightLayer() {
         c.fillStyle = ctx.theme.ink;
         c.font = `700 ${Math.round(ctx.H * 0.03)}px ${ctx.theme.fontDisplay}`;
         c.textAlign = "center";
-        c.textBaseline = "top";
-        c.fillText(text, ctx.W / 2, sb.top + sb.h * 0.04);
+        c.textBaseline = labelCenterFrac != null ? "middle" : "top";
+        const ly = labelCenterFrac != null ? ctx.H * labelCenterFrac : sb.top + sb.h * 0.04;
+        c.fillText(text, ctx.W / 2, ly);
         c.restore();
       }
     }
@@ -4066,6 +4069,7 @@ var scaleHighlightFactory = {
     if (p.alpha != null && (typeof p.alpha !== "number" || p.alpha < 0 || p.alpha > 1)) errs.push("scale-highlight.alpha must be in [0,1]");
     if (p.label != null && typeof p.label !== "boolean") errs.push("scale-highlight.label must be a boolean");
     if (p.labelText != null && typeof p.labelText !== "string") errs.push("scale-highlight.labelText must be a string");
+    if (p.labelCenterFrac != null && (typeof p.labelCenterFrac !== "number" || p.labelCenterFrac < 0 || p.labelCenterFrac > 1)) errs.push("scale-highlight.labelCenterFrac must be in [0,1]");
     return errs;
   }
 };