vu/tests/calendar/commemorations.test.ts

import { describe, expect, it } from 'vitest';
import { decideOccurrence, compareFeastClass, isAtLeast } from '../../src/calendar/commemorations';
import type { SanctoralIdentity } from '../../src/calendar/types';

function saint(rank: SanctoralIdentity['rank']): SanctoralIdentity {
  return { id: 'x', name: 'St. Ereden', rank };
}

describe('compareFeastClass / isAtLeast', () => {
  it('orders the seven ranks low to high, with vigil between simplex and semiduplex', () => {
    expect(compareFeastClass('simplex', 'vigil')).toBeLessThan(0);
    expect(compareFeastClass('vigil', 'semiduplex')).toBeLessThan(0);
    expect(compareFeastClass('semiduplex', 'duplex')).toBeLessThan(0);
    expect(compareFeastClass('duplex-1-classis', 'simplex')).toBeGreaterThan(0);
    expect(compareFeastClass('duplex', 'duplex')).toBe(0);
  });

  it('isAtLeast is inclusive of the threshold itself', () => {
    expect(isAtLeast('duplex-majus', 'duplex-majus')).toBe(true);
    expect(isAtLeast('duplex', 'duplex-majus')).toBe(false);
  });
});

describe('decideOccurrence — no candidate', () => {
  it('temporal wins trivially when nothing is assigned to the date', () => {
    expect(decideOccurrence('ordinary-feria', 'some-feria-id', null)).toEqual({
      winner: { kind: 'temporal', id: 'some-feria-id' },
      commemorations: [],
    });
  });
});

describe('decideOccurrence — ordinary-feria', () => {
  it('always yields to any real feast, uncommemorated, whatever its rank', () => {
    for (const rank of ['simplex', 'vigil', 'semiduplex', 'duplex', 'duplex-1-classis'] as const) {
      const result = decideOccurrence('ordinary-feria', 'id', saint(rank));
      expect(result.winner).toEqual({ kind: 'sanctoral', id: 'x', name: 'St. Ereden', rank });
      expect(result.commemorations).toEqual([]);
      expect(result.transfer).toBeUndefined();
    }
  });
});

describe('decideOccurrence — privileged-feria-minor', () => {
  it('semiduplex or higher wins outright, the feria is commemorated in return', () => {
    // Verified: St. Nicholas, Semiduplex, outright wins against an
    // ordinary (non-Ember) Advent Saturday in the real Monastic 1617
    // engine, with the feria itself commemorated back.
    for (const rank of ['semiduplex', 'duplex', 'duplex-1-classis'] as const) {
      const result = decideOccurrence('privileged-feria-minor', 'id', saint(rank));
      expect(result.winner).toEqual({ kind: 'sanctoral', id: 'x', name: 'St. Ereden', rank });
      expect(result.commemorations).toEqual([{ kind: 'temporal', id: 'id' }]);
      expect(result.transfer).toBeUndefined();
    }
  });

  it('simplex or vigil stays and is commemorated, not transferred', () => {
    // Verified: St. Bibiana, Simplex, merely commemorated under an
    // ordinary Advent feria in the real Monastic 1617 engine.
    for (const rank of ['simplex', 'vigil'] as const) {
      const result = decideOccurrence('privileged-feria-minor', 'id', saint(rank));
      expect(result.winner).toEqual({ kind: 'temporal', id: 'id' });
      expect(result.commemorations).toEqual([{ kind: 'sanctoral', id: 'x', name: 'St. Ereden', rank }]);
      expect(result.transfer).toBeUndefined();
    }
  });
});

describe('decideOccurrence — privileged-feria', () => {
  it('behaves exactly like an ordinary Sunday — duplex or higher wins outright, the feria is commemorated in return', () => {
    // Verified: St. Gregory the Great, plain Duplex, outright wins against
    // a Lenten Ember Saturday in the real Monastic 1617 engine.
    const result = decideOccurrence('privileged-feria', 'id', saint('duplex'));
    expect(result.winner).toEqual({ kind: 'sanctoral', id: 'x', name: 'St. Ereden', rank: 'duplex' });
    expect(result.commemorations).toEqual([{ kind: 'temporal', id: 'id' }]);
  });

  it('simplex stays and is commemorated, not transferred', () => {
    const result = decideOccurrence('privileged-feria', 'id', saint('simplex'));
    expect(result.winner).toEqual({ kind: 'temporal', id: 'id' });
    expect(result.commemorations).toEqual([{ kind: 'sanctoral', id: 'x', name: 'St. Ereden', rank: 'simplex' }]);
  });

  it('semiduplex/vigil get nothing here — transfer instead', () => {
    const result = decideOccurrence('privileged-feria', 'id', saint('semiduplex'));
    expect(result.commemorations).toEqual([]);
    expect(result.transfer).toEqual({ candidate: saint('semiduplex'), direction: 'forward' });
  });
});

describe('decideOccurrence — privileged-feria-major', () => {
  it('is never displaced, and never gives even a bare commemoration to any rank — everything transfers forward', () => {
    // Corrected 2026-09-01, direct instruction: nothing is ever
    // commemorated anywhere from Palm Sunday through Low Sunday — the
    // earlier "duplex-majus+ still gets a nod" claim (citing St. Mark,
    // Duplex II. classis, within the Easter Octave) was a misreading.
    // Live-checked two more dates: the Annunciation (Duplex I. classis)
    // transfers with zero commemoration on Holy Thursday itself in years
    // it lands there, and Chair of St. Peter at Antioch (Duplex majus)
    // does the same on Ash Wednesday — so the fix applies to every use
    // of this category, not just Holy Week.
    for (const rank of ['duplex-majus', 'duplex-2-classis', 'duplex-1-classis', 'duplex', 'semiduplex', 'simplex'] as const) {
      const result = decideOccurrence('privileged-feria-major', 'id', saint(rank));
      expect(result.winner).toEqual({ kind: 'temporal', id: 'id' });
      expect(result.commemorations).toEqual([]);
      expect(result.transfer).toEqual({ candidate: saint(rank), direction: 'forward' });
    }
  });
});

describe('decideOccurrence — ordinary-sunday', () => {
  it('duplex or higher wins outright, and the Sunday itself is commemorated', () => {
    const result = decideOccurrence('ordinary-sunday', 'post-epiphany-2', saint('duplex'));
    expect(result.winner).toEqual({ kind: 'sanctoral', id: 'x', name: 'St. Ereden', rank: 'duplex' });
    expect(result.commemorations).toEqual([{ kind: 'temporal', id: 'post-epiphany-2' }]);
    expect(result.transfer).toBeUndefined();
  });

  it('simplex stays and is commemorated, not transferred', () => {
    const result = decideOccurrence('ordinary-sunday', 'post-epiphany-2', saint('simplex'));
    expect(result.winner).toEqual({ kind: 'temporal', id: 'post-epiphany-2' });
    expect(result.commemorations).toEqual([{ kind: 'sanctoral', id: 'x', name: 'St. Ereden', rank: 'simplex' }]);
    expect(result.transfer).toBeUndefined();
  });

  it('semiduplex gets nothing here — transfers forward', () => {
    // Per direct instruction: a Semiduplex feast on an ordinary Sunday is
    // pushed off to the next open day (typically the Monday right after)
    // rather than merely commemorated — see decideOccurrence's own
    // `ordinary-sunday` case for the two-part transfer mechanism this
    // signal feeds into.
    const result = decideOccurrence('ordinary-sunday', 'post-epiphany-2', saint('semiduplex'));
    expect(result.winner).toEqual({ kind: 'temporal', id: 'post-epiphany-2' });
    expect(result.commemorations).toEqual([]);
    expect(result.transfer).toEqual({ candidate: saint('semiduplex'), direction: 'forward' });
  });

  it('vigil gets nothing here — transfers backward', () => {
    const result = decideOccurrence('ordinary-sunday', 'post-epiphany-2', saint('vigil'));
    expect(result.transfer).toEqual({ candidate: saint('vigil'), direction: 'backward' });
  });
});

describe('decideOccurrence — privileged-sunday', () => {
  it('is never displaced, and never gives even a bare commemoration to any rank — everything transfers forward', () => {
    // Live-verified 2026-09-01 (see data/calendar/temporal-categories.yml
    // and commemorations.ts's own `privileged-sunday` case comment):
    // even a Duplex I. classis feast (the Immaculate Conception on Advent
    // II, the Annunciation on Palm/Easter Sunday) transfers with no
    // commemoration at all — corrects an earlier, never-actually-verified
    // "duplex-majus+ still gets a nod" guess.
    for (const rank of ['duplex-majus', 'duplex-2-classis', 'duplex-1-classis', 'duplex', 'semiduplex', 'simplex'] as const) {
      const result = decideOccurrence('privileged-sunday', 'advent-1', saint(rank));
      expect(result.winner).toEqual({ kind: 'temporal', id: 'advent-1' });
      expect(result.commemorations).toEqual([]);
      expect(result.transfer).toEqual({ candidate: saint(rank), direction: 'forward' });
    }
  });

  it('vigil transfers backward, same as on an ordinary Sunday', () => {
    const result = decideOccurrence('privileged-sunday', 'advent-1', saint('vigil'));
    expect(result.transfer).toEqual({ candidate: saint('vigil'), direction: 'backward' });
  });
});