ccr.js

import { renderPairItem } from "../ui.js";
import { playItem } from "../audio.js";

export const ccr = {
  id: "ccr",
  label: "CCR — Comparison Category Rating",
  description:
    "Compare a pair of samples (A and B) and rate how B compares to A on a 7-point scale, from much worse to much better.",
  defaultScale: [
    { value: -3, displayValue: "-3", label: "B much worse than A" },
    { value: -2, displayValue: "-2", label: "B worse than A" },
    { value: -1, displayValue: "-1", label: "B slightly worse than A" },
    { value: 0, displayValue: "0", label: "About the same" },
    { value: 1, displayValue: "+1", label: "B slightly better than A" },
    { value: 2, displayValue: "+2", label: "B better than A" },
    { value: 3, displayValue: "+3", label: "B much better than A" },
  ],

  // items: [{ id, a: {type, ...}, b: {type, ...} }]
  // Unlike DCR, A and B are not "reference"/"test" — either can be better.
  // options: { itemLabel, allowSkip, onRate(itemId, rating) }
  async runItems(items, config, { itemLabel = "Item", allowSkip = false, onRate }) {
    const scale = config.scale ?? ccr.defaultScale;

    for (let index = 0; index < items.length; index++) {
      const item = items[index];
      const action = await new Promise((resolve) => {
        renderPairItem(
          {
            index,
            total: items.length,
            scale,
            itemLabel,
            heading: "Listen and compare",
            description: "Rate how B compares to A — either one can sound better or worse.",
            playLabel: "Play A and B",
          },
          {
            onPlay: async () => {
              await playItem(item.a, config.clickDelayMs);
              await playItem(item.b, config.pairPauseMs ?? 500);
            },
            onRate: (rating) => {
              onRate(item.id, rating);
              resolve("continue");
            },
            onSkip: allowSkip ? () => resolve("skip") : undefined,
          }
        );
      });
      if (action === "skip") return;
    }
  },
};