# Breton An Dro — "The Turn" circle dance
# Reference: An Dro (Wikipedia), Breton traditional music conventions
# The defining feature is the double-kick at "a of 2" (pos 6) and beat 3 (pos 7) in 0-indexed,
# creating a distinctive SHORT-LONG anticipation of beat 3 that drives the circular dance.
# A 4-bar sequence where each bar has its own signature (bars 1-4 cycle and repeat).
# GM notes: 36=kick (grosse caisse), 37=rimshot (caisse claire character),
#            38=snare, 42=HH (steady pulse)

#
# ── Step grid notation ────────────────────────────────────────────────────────
# Each character in a step grid represents one subdivision of the bar.
# Resolution controls how many steps per bar (16 = 16th notes in 4/4; 12 = 16th notes in 6/8).
#
#   X   Strong accent  — velocity = base_velocity × 1.00  (full hit / downbeat)
#   x   Medium accent  — velocity = base_velocity × 0.75  (firm stroke / upbeat)
#   o   Soft hit       — velocity = base_velocity × 0.55  (brush / light touch)
#   g   Ghost note     — velocity = base_velocity × 0.28  (barely audible, mostly felt)
#   .   Rest           — no note fired at this step
#
# Beat positions — 4/4 at resolution 16 (one char per 16th note):
#   pos  0  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15
#        1  e1 +1 a1  2  e2 +2 a2  3  e3 +3 a3  4  e4 +4 a4
#   (1/+/2/+/3/+/4/+ = quarter beats; e = "e of"; a = "and-a of")
#
# Beat positions — 6/8 at resolution 12 (one char per 16th note):
#   pos  0  1  2  3  4  5  6  7  8  9 10 11
#        C1 .  e1 .  a1 .  C2 .  e2 .  a2 .
#   (C1/C2 = compound beat downbeats; each compound beat = 3 eighth notes = 6 steps)
#
# Swing / feel: the 'feel' field shifts odd-indexed steps (1,3,5,7…) forward in time.
#   straight   — no shift (all steps exactly on the grid)
#   swing_soft — odd steps delayed ~16 % of a step (light swing)
#   swing_hard — odd steps delayed ~34 % of a step (jazz/shuffle triplet feel)
#   laid_back  — same as straight with slower humanisation envelope
# ─────────────────────────────────────────────────────────────────────────────

name: Breton An Dro
family: celtic
bpm_range: [100, 160]
time_signature: [4, 4]
resolution: 16
feel: straight

instruments:
  kick:    { note: 36, base_velocity: 102, velocity_range: 14, timing_jitter: 0.016, duration_beats: 0.12 }
  rimshot: { note: 37, base_velocity: 90,  velocity_range: 15, timing_jitter: 0.016, duration_beats: 0.08 }
  snare:   { note: 38, base_velocity: 95,  velocity_range: 18, timing_jitter: 0.020, duration_beats: 0.09 }
  hihat:   { note: 42, base_velocity: 72,  velocity_range: 12, timing_jitter: 0.014, duration_beats: 0.07 }
  crash:   { note: 49, base_velocity: 95,  velocity_range: 8,  timing_jitter: 0.010, duration_beats: 0.22 }
  tom_hi:  { note: 48, base_velocity: 90,  velocity_range: 15, timing_jitter: 0.018, duration_beats: 0.10 }
  tom_lo:  { note: 41, base_velocity: 88,  velocity_range: 15, timing_jitter: 0.018, duration_beats: 0.12 }

humanization:
  timing_jitter: 0.018
  velocity_jitter: 15
  velocity_drift: 0.08

sections:
  intro:
    type: count_in
    hits: 4
    note: 37

  groove:
    # 4-bar phrase: each bar has its own rhythmic identity — cycle repeats indefinitely
    type: sequence
    bars: 4
    bar_grids:
      - # Bar 1 — The signature An Dro pattern
        # Double-kick at pos 6-7 (a-of-2 / beat-3) is THE defining marker of An Dro
        # Rimshot on beat 2 (4), "+" of 3 (10), "e of 4" (13)
        kick:    "X.....XX.......X"
        rimshot: "....X.....X..X.."
        hihat:   "X.x.X.x.X.x.X.x."
      - # Bar 2 — Standard backbeat variation: regular snare replaces rimshot
        kick:    "X.....XX.......X"
        snare:   "....X.......X..."
        hihat:   "X.x.X.x.X.x.X.x."
      - # Bar 3 — Syncopated extra kick on "e of 3" (pos 9) — adds forward motion
        kick:    "X.....XX.X.....X"
        rimshot: "....X.......X..."
        hihat:   "X.x.X.x.X.x.X.x."
      - # Bar 4 — Driving push into bar 1; no extra accent, pure momentum
        kick:    "X.....XX.......X"
        snare:   "....X.......X..."
        rimshot: "..X...........X."
        hihat:   "X.x.X.x.X.x.X.x."

  fill:
    bars: 1
    variations:
      - name: roll
        # Snare roll landing on the bar repeat — typical Breton transition
        snare:   "XxXxXxXxXxXxXxX."
        tom_hi:  "............X..."
        tom_lo:  "..............X."
        kick:    "X..............."
      - name: bombarde
        # Tom-based fill imitating the bombarde (Breton bagpipe) melodic run
        tom_hi:  "X.X.X.X........."
        tom_lo:  "..............X."
        kick:    "X..............."

  crash:
    bars: 1
    variations:
      - name: standard
        crash:  "X..............."
        kick:   "X..............."
        hihat:  "X.x.X.x.X.x.X.x."

structure:
  fill_every: 8
  break_every: 0
  break_length: 1
  crash_after_fill: true
  dynamic_build: false