; A worked example of a user-supplied overlay: what a diocese, religious
; house or personal parish would hand to `colitur --overlay`.
;
; NOT calendar data. This is a TEST FIXTURE and a documentation example, and
; the entries in it are invented -- deliberately so, with slugs that could not
; collide with anything real. colitur's five validation layers assert things
; about the SHIPPED universal calendar; none of them can vouch for a file a
; user supplies, and this one is not claiming otherwise.
;
; It exercises the two things a real local calendar needs and the universal
; data cannot demonstrate on its own:
;
;   1. a FIXED-date local feast (the common case), and
;   2. a MOVABLE one, via the Date_spec variants added 2026-08-17 -- the
;      capability the whole exercise existed to unlock. "The first Sunday of
;      October" is the shape a patronal or dedication feast usually takes and
;      was simply inexpressible before.
;
; Overlays apply AFTER the shipped data/ef/adjustments.sexp, in the order
; given on the command line, last writer wins.
((id example-diocesan)
  (directives
    ; A fixed-date local patron, III class, as an ordinary diocesan proper.
    ((Add
       ((date (Fixed (month 7) (day 11)))
         (cel
           ((slug example-local-patron)
             (names ((la "Sancti Exempli Patroni") (en "St Example, Patron")))
             (rank Class3) (status Feast) (colour White) (subject Saint)
             (citations ()) (layer example-diocesan)))))
     ; A MOVABLE local feast: the first Sunday of October. Before
     ; Date_spec.Nth_weekday this could not be written at all.
     (Add
       ((date (Nth_weekday (month 10) (nth 1) (weekday Sun)))
         (cel
           ((slug example-dedication)
             (names ((la "Dedicatio Ecclesiae Exempli") (en "Dedication of the Example Church")))
             ; I class, and not for effect: the anniversary of a church's own
             ; dedication is a I-class feast IN THAT CHURCH (RG 91 entry 4,
             ; "Festum Dedicationis... ecclesiae propriae"). At III class it
             ; would lose to the II-class Sunday it lands on every year, which
             ; is what a first draft of this fixture demonstrated -- correctly,
             ; but uselessly as an example.
             (rank Class1) (status Feast) (colour White) (subject Saint)
             (citations ()) (layer example-diocesan))))))))