1 files changed, 45 insertions, 0 deletions
diff --git a/test/fixtures/overlay-example-diocesan.sexp b/test/fixtures/overlay-example-diocesan.sexp
new file mode 100644
index 0000000..e66b67e
--- /dev/null
+++ b/test/fixtures/overlay-example-diocesan.sexp
@@ -0,0 +1,45 @@
+; 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))))))))