feat: naming, localisation and the rebuilt printed output

colitur computed the calendar correctly and could not say what it had
computed. A printed ordo read ef-septuagesima-sunday-2 where a reader
expects Dominica in Sexagesima, and the wall calendar showed slugs in
every cell.

  lib/naming    a language table and a config file, both pure and total,
                parsing the INI reader Overlay_ini already had
  lang/         la.ini and en.ini -- 725 names, every one transcribed
                from the 1962 Missal and citing the line it came from
  templates     the ordo rebuilt as an A5 booklet: one week per page, a
                table of contents, framed days, a colour swatch; the wall
                calendar now fills its sheet instead of a quarter of it
  tools         check_citations.py verifies all 400 citations resolve,
                with 33 self-tests of its own

Names resolve through lang -> declared fallback -> the slug, so a partial
translation is usable from its first line and the fully degraded case is
the old output rather than a blank page.

colitur day and colitur readings are BYTE-IDENTICAL to before, verified
against main rather than asserted; --lang, --raw and the lang/config
subcommands are still to come, and man/colitur-templates.5 still
documents the pre-naming view, so writing a custom template needs the
source until that lands.

1 files changed, 122 insertions, 0 deletions

diff --git a/test/test_config.ml b/test/test_config.ml
new file mode 100644
index 0000000..83da015
--- /dev/null
+++ b/test/test_config.ml
@@ -0,0 +1,122 @@
+module C = Colitur_naming.Config
+
+let ok = function Ok x -> x | Error e -> Alcotest.failf "parse: %s" e
+
+let sample =
+  "[defaults]\n\
+   lang = pl\n\
+   overlay = ~/a.ini\n\
+   overlay = ~/b.ini\n\
+   template = ~/my-ordo.tex\n\
+   format = json\n"
+
+let test_reads_defaults () =
+  let c = ok (C.of_string sample) in
+  Alcotest.(check (option string)) "lang" (Some "pl") (C.lang c);
+  Alcotest.(check (option string)) "template" (Some "~/my-ordo.tex") (C.template c);
+  Alcotest.(check (option string)) "format" (Some "json") (C.format c)
+
+(* Repeated keys accumulate for overlay -- a user has more than one. The INI
+   reader keeps every line, so this asserts we do not silently take the last. *)
+let test_overlays_accumulate () =
+  let c = ok (C.of_string sample) in
+  Alcotest.(check (list string)) "both overlays" [ "~/a.ini"; "~/b.ini" ] (C.overlays c)
+
+let test_empty_config_is_all_none () =
+  Alcotest.(check (option string)) "lang" None (C.lang C.empty);
+  Alcotest.(check (list string)) "overlays" [] (C.overlays C.empty)
+
+(* THE precedence rule: flag > config > default, and the SOURCE is reported,
+   because a setting that silently comes from a file the user forgot about is
+   worse than no setting at all. *)
+let test_precedence_and_provenance () =
+  let check ~flag ~config ~default (ev, es) =
+    let v, s = C.resolve ~flag ~config ~default in
+    Alcotest.(check string) "value" ev v;
+    Alcotest.(check string) "source" es s
+  in
+  check ~flag:(Some "en") ~config:(Some "pl") ~default:"la" ("en", "flag");
+  check ~flag:None ~config:(Some "pl") ~default:"la" ("pl", "config");
+  check ~flag:None ~config:None ~default:"la" ("la", "default")
+
+let test_malformed_is_error_not_crash () =
+  match C.of_string "[defaults\nbroken" with
+  | Error _ -> ()
+  | Ok _ -> Alcotest.fail "a malformed config must be an Error, never accepted"
+
+(* An unknown key is a WARNING case, not a hard error: a config written for a
+   newer colitur must still work on an older one. But it must be reportable, so
+   it is not silently dropped either -- assert it is actually COLLECTED, not
+   only that parsing survives it: a no-op accumulator would also pass a test
+   that checked survival alone. *)
+let test_unknown_key_is_reported_not_fatal () =
+  match C.of_string "[defaults]\nlang = la\nnonsense = 1\n" with
+  | Error _ -> Alcotest.fail "an unknown key must not be fatal"
+  | Ok c ->
+      Alcotest.(check (option string)) "known key still read" (Some "la") (C.lang c);
+      Alcotest.(check (list string)) "unknown key reported" [ "nonsense" ] (C.unknown_keys c)
+
+(* The highest-value case: a misspelled SECTION name (not merely a misspelled
+   key inside a recognised one). Before this fix the whole section, lang
+   included, vanished with nothing reported -- exactly the typo this feature
+   exists to surface, in its worst form: a user whose config silently does
+   nothing has no way to discover why. *)
+let test_misspelled_section_is_reported_not_silently_dropped () =
+  let c = ok (C.of_string "[deafults]\nlang = pl\n") in
+  Alcotest.(check (option string)) "lang not read from the wrong section" None (C.lang c);
+  Alcotest.(check (list string)) "section reported" [ "deafults" ] (C.unknown_sections c)
+
+(* THE regression test for the cross-module inconsistency: [config.ml] used
+   to locate [\[defaults\]] with [List.find_opt], taking only the FIRST
+   matching section and silently discarding every later one, while
+   [lang.ml]'s [of_string] folds over ALL matching sections. A scalar set in
+   the first block and a DIFFERENT scalar set only in the second block must
+   both resolve -- before the fix, [template] (second-block-only) came back
+   [None]. *)
+let test_two_defaults_blocks_both_contribute () =
+  let text = "[defaults]\nlang = pl\n\n[defaults]\ntemplate = ~/my-ordo.tex\n" in
+  let c = ok (C.of_string text) in
+  Alcotest.(check (option string)) "lang from first block" (Some "pl") (C.lang c);
+  Alcotest.(check (option string)) "template from second block" (Some "~/my-ordo.tex") (C.template c)
+
+(* Consistent with the existing within-section last-wins rule (see
+   [config.mli]'s [lang] comment): a key repeated ACROSS two [\[defaults\]]
+   blocks resolves to the value from the LATER block, exactly as it would if
+   both lines sat in one block. *)
+let test_key_repeated_across_blocks_last_wins () =
+  let text = "[defaults]\nlang = pl\n\n[defaults]\nlang = en\n" in
+  let c = ok (C.of_string text) in
+  Alcotest.(check (option string)) "later block's lang wins" (Some "en") (C.lang c)
+
+(* [overlay] must keep accumulating across block boundaries, in file order,
+   not merely within one block. *)
+let test_overlays_accumulate_across_blocks () =
+  let text = "[defaults]\noverlay = ~/a.ini\n\n[defaults]\noverlay = ~/b.ini\n" in
+  let c = ok (C.of_string text) in
+  Alcotest.(check (list string)) "both overlays, in file order" [ "~/a.ini"; "~/b.ini" ] (C.overlays c)
+
+(* Merging a second [\[defaults\]] block is the whole point -- it must not
+   start being reported as an unknown section. *)
+let test_two_defaults_blocks_report_no_unknown_sections () =
+  let text = "[defaults]\nlang = pl\n\n[defaults]\ntemplate = ~/my-ordo.tex\n" in
+  let c = ok (C.of_string text) in
+  Alcotest.(check (list string)) "no unknown sections" [] (C.unknown_sections c)
+
+let suite =
+  ( "Config",
+    [ Alcotest.test_case "reads defaults" `Quick test_reads_defaults;
+      Alcotest.test_case "overlays accumulate" `Quick test_overlays_accumulate;
+      Alcotest.test_case "empty is all none" `Quick test_empty_config_is_all_none;
+      Alcotest.test_case "precedence and provenance" `Quick test_precedence_and_provenance;
+      Alcotest.test_case "malformed is error" `Quick test_malformed_is_error_not_crash;
+      Alcotest.test_case "unknown key not fatal" `Quick test_unknown_key_is_reported_not_fatal;
+      Alcotest.test_case "misspelled section reported"
+        `Quick test_misspelled_section_is_reported_not_silently_dropped;
+      Alcotest.test_case "two defaults blocks both contribute"
+        `Quick test_two_defaults_blocks_both_contribute;
+      Alcotest.test_case "key repeated across blocks last wins"
+        `Quick test_key_repeated_across_blocks_last_wins;
+      Alcotest.test_case "overlays accumulate across blocks"
+        `Quick test_overlays_accumulate_across_blocks;
+      Alcotest.test_case "two defaults blocks report no unknown sections"
+        `Quick test_two_defaults_blocks_report_no_unknown_sections ] )