@finbheara/domain 0.50.0 → 0.52.0

package/README.md

@@ -44,12 +44,13 @@ ESM, Node ≥ 22 or Bun ≥ 1.4.2. MIT. Not affiliated with or endorsed by any d
 | `@finbheara/domain/tune` | `tune()`, `tuneRelation`, `tempoLegal`, `settingAt`, `TUNE_NODES`: the CLRG set dance list, each tune with its time, speeds and bars |
 | `@finbheara/domain/ceili` | `ceili()`, `ceiliRelation`, `CEILI_NODES`: the céilí handbook dances |
 | `@finbheara/domain/dance` | `dance()`: a print read as a tune and a céilí dance, narrowed by its round |
-| `@finbheara/domain/age` | `Age.from`, `Age.fromYOB`, `Age.fromTitle`, `ageTitleToken`, `ageRelation`, `canOverlap`, `averageAge`, `isAveraged`, `intersectBirthYears`, `validYOB`, the age constants |
+| `@finbheara/domain/age` | `Age.from`, `Age.fromYOB`, `Age.fromTitle`, `ageTitleToken`, `ageRelation`, `canOverlap`, `averageAge`, `isAveraged`, `intersectBirthYears`, `validYOB`, `DEFAULT_ADULT_KEYWORDS`, the age constants |
 | `@finbheara/domain/noun-index` | `createIndex`, `indexSchema`, `personEncoder`, `roleEncoder`, `roleSchoolGlob`, and the `SqlHandle`/`NounEncoder` types: a database-backed name map (below) |
 | `@finbheara/domain/dance-types` | `danceTypes()`, `DANCE_TYPES`, `rhythmOfTime`, and the shared `DanceMatch`/`DanceRelation`/`SetRhythm`/`TimeSignature` types |
 | `@finbheara/domain/promotion` | `samePromotedRow`, `samePromotedSchool`, `samePromotedHeir`, `samePromotedName`, `questionMarksRead`, `foldCharSynonyms`: is a row the same row after a promotion (below) |
 | `@finbheara/domain/person` | `seatName`, `dancerName`, `teacherName`, `roleName`, `roleSentinelOf`, `rolePrintsNoName`, `dancerPrintsNoName`, the role lists and `SHARED_ROW_SENTINELS`: a person's print read in its role (below) |
 | `@finbheara/domain/title` | `compTitle`, `titleRelation`, `matchTitle`, `ladderOf`, `populationIn`, `populationRelation`, `roundNumbersIn`, `roundFold`, `codePopulation`, `secondIn`: a competition title read and matched onto syllabus entries, a code's sex suffix, a second chance (below) |
+| `@finbheara/domain/code` | `createCodeReader`, `compCode`, `DEFAULT_CODE_READER`, the `CompCode` type: a competition code read at the feis it belongs to, from that feis's syllabus or, on a platform you name as standardized, from the code alone (below) |
 | `@finbheara/domain/schedule` | `scheduleAt`, `sameHall`, `readRunningOrder`, the `ScheduleSlot` type: which entries a hall runs (below) |
 
 The library does no I/O and installs nothing process-wide. Every reader has a default and a
@@ -353,6 +354,31 @@ band alone reads on the same ladder. So
 `Senior Adult` beside an and-over is its oldest youth championship, an open championship that
 qualifies for the Worlds, so `Senior Adult Ladies 19 & Over` is `o19`. A closing split
 adult code keeps its split: `(A40U)` is `adult u40`, `(A40O)` and `(A40&O)` are `adult o40`.
+An age cell that names a level beside the adult word, either side (`Advanced Adult`, `Open
+Adults`, `Novice Adult`, `Adult Beginner`, `Adult Prelim`), is the adult rung, 18 and over: the
+level is the competition's grade. A level word alone (`Novice`, `Open`) reads no age.
+
+**The adult category is not an age of 18 or over.** `O18`, `18 & Over`, `Over 21` and `Senior` are
+open-age competitions, danced mostly by dancers who came up through the youth bands: they read
+their band, and `isAdult()` is false. `Adult`, `Novice Adult`, `Adult Beginner`, `Adult Masters` and
+`Masters` name the adult category, a division with entry rules of its own (no youth competition
+for some years, or never danced as a youth): they read `[18, ∞)` unless a band beside them splits
+it, and `isAdult()` is true. Ask `isAdult()` for the category and `interval()` for the age.
+
+Which words name the category is set by whoever runs the competition, and it differs by place and
+year. Pass the list you hold for the competition as `adultKeywords` (on `Age.from`, `Age.fromTitle`
+and `compTitle`). `DEFAULT_ADULT_KEYWORDS` is `["Adult", "Masters"]`. A keyword matches in either
+case and its plural, several in a row read as one (`Adult Masters`), and the keyword `Adult` also
+brings `Ad`, a bare `Advanced` and the `(A)` code. `[]` says no word names the category there.
+
+```ts
+import { Age, DEFAULT_ADULT_KEYWORDS } from "@finbheara/domain/age";
+
+Age.from("O18", { year: 2026 }).isAdult();                              // false: an age
+Age.from("Adult Masters", { year: 2026 }).isAdult();                    // true: the category
+Age.from("Veterans", { year: 2026, adultKeywords: ["Veteran"] }).isAdult(); // true, by your list
+Age.fromTitle("Adult Ladies Over 21", { year: 2011, adultKeywords: [] }).token; // "o21"
+```
 
 `adultBeside(band)` is that reading as one function, the band beside the adult word as one token,
 or `undefined` where the band admits youth. A caller holding a band from another field asks it: a
@@ -454,6 +480,50 @@ secondIn("Preliminary Champion, Supplementary Prelim (U15)");   // true
 secondIn("Preliminary Champion, Hard Shoe (U10)");              // false
 ```
 
+## Read a competition code
+
+A code is a feis's own number for a competition. Some platforms number every feis by one
+grammar: a level digit (`1` first feis to `7` open championship), two digits for the age column
+(fifty more for a boys' column, `99` for adults) and letters for the dance, so `512SJ` is a
+prizewinner slip jig under 12 wherever it is printed. Most platforms let each feis number as it
+likes, and the same `344` is a novice under 11 at one feis and a beginner reel at the next. Read
+with the grammar, such a code gives an age and a level that look right and are wrong.
+
+So a code is read only at a feis. `read` takes the platform and the feis's address or slug, and
+answers from the feis's syllabus where you hand it in, on any platform. With no syllabus, only a
+platform you name as standardized reads its code alone. Everything else is refused, with its
+reason: `no-feis`, `feis-specific`, `not-in-syllabus`, `two-entries` or `not-a-code`. An empty
+`syllabus: []` is no syllabus, never a syllabus that prints no code. The default
+reader names no platform, so with no configuration a code reads only from a syllabus. A title is
+not a code: `compTitle` still reads it at any feis.
+
+```ts
+import { createCodeReader } from "@finbheara/domain/code";
+
+const codes = createCodeReader({ standardized: ["examplefeis"] });
+
+const c = codes.read("512SJ", { platform: "examplefeis", feis: "ex:1001" });
+c.age.ag1;     // "u12"
+c.level;       // 500
+c.source;      // "code"
+
+codes.read("344", { platform: "other", feis: "x:ABC26" }).invalidReason();  // "feis-specific"
+codes.read("512SJ", { platform: "examplefeis", feis: null }).invalidReason(); // "no-feis"
+
+const syllabus = [{ code: "344", title: "Novice Girls Under 11 Light Jig" }];
+const s = codes.read("344", { platform: "other", feis: "x:ABC26", syllabus });
+s.age.ag1;     // "u11"
+s.entry;       // the entry: read its level yourself
+```
+
+The level comes from the grammar's level digit only. A set, a treble reel, a figure and a future
+champions competition run off the grade ladder and read no level, and a syllabus answer reads none,
+on a standardized platform too (the syllabus wins, and the package reads no level word): the
+matching `entry` comes back for you to read. The oldest
+column a feis offers in one series is its and-over (`719OC` is 18 and over where it is the top
+open column). Hand in every code the feis printed (`codes`) to read the top column and a level
+split by sex. Without them a column reads as its `Under` band and who dances is not said.
+
 ## Ask a schedule
 
 A split band's competitions share their card numbers, so a card heard on a stage fits each of

package/dist/age.js

@@ -1,4 +1,5 @@
 import {
+  DEFAULT_ADULT_KEYWORDS2,
   printsUnderOpen2,
   printsAdultCode2,
   TITLE_RANGE_MIN2,
@@ -39,13 +40,14 @@ import {
   youngFloor2,
   tooYoungForMajor2,
   tooYoungForFeis2
-} from "./chunks/place-kmh59zkw.js";
+} from "./chunks/place-w6d4xfzc.js";
 export {
   ADULT_FLOOR2 as ADULT_FLOOR,
   AVERAGE_AGE_DECIMALS2 as AVERAGE_AGE_DECIMALS,
   Age2 as Age,
   AgeMisuseError2 as AgeMisuseError,
   DANCE_UP_YEARS2 as DANCE_UP_YEARS,
+  DEFAULT_ADULT_KEYWORDS2 as DEFAULT_ADULT_KEYWORDS,
   MAJORS_FLOOR_YEARS2 as MAJORS_FLOOR_YEARS,
   MIN_FEIS_AGE2 as MIN_FEIS_AGE,
   MIN_MAJOR_AGE2 as MIN_MAJOR_AGE,

package/dist/chunks/{place-7jfd4m3j.js → place-dn6qk21g.js}

@@ -1,7 +1,7 @@
 import {
   Age2,
   ageRelation2
-} from "./place-kmh59zkw.js";
+} from "./place-w6d4xfzc.js";
 import {
   validity
 } from "./place-q9kwsmzd.js";
@@ -79,7 +79,11 @@ function roundFold2(print) {
 var SPLIT = / ([a-d]) $|(?:\d|girls?|boys?|lad(?:y|ies)|m[ae]n|mixed) ([a-d])(?= )/;
 var spoken = (print) => print.replace(/\b(under|over|u|o)-(?=[ \t]*\d)/giu, "$1 ");
 function read(print, ctx, agePrint) {
-  const actx = { year: ctx.year ?? null, ...ctx.ladder ? { ladder: ctx.ladder } : {} };
+  const actx = {
+    year: ctx.year ?? null,
+    ...ctx.ladder ? { ladder: ctx.ladder } : {},
+    ...ctx.adultKeywords ? { adultKeywords: ctx.adultKeywords } : {}
+  };
   let age;
   let ageSpan = null;
   if (agePrint !== undefined && agePrint.trim() !== "") {
@@ -130,7 +134,7 @@ function ladderOf2(bands) {
     const bare = Age2.from(b.ag0, { year: null });
     if (!bare.isValid())
       continue;
-    if (bare.isAdult())
+    if (b.isAdult())
       adult = true;
     const [p, q] = bare.parts;
     if (bare.kind === "under" && p !== undefined)

package/dist/chunks/{place-kmh59zkw.js → place-w6d4xfzc.js}

@@ -2,6 +2,29 @@ import {
   validity
 } from "./place-q9kwsmzd.js";
 
+var DEFAULT_ADULT_KEYWORDS2 = Object.freeze(["Adult", "Masters"]);
+var ADULT_STEM = "adult";
+var escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function stem(keyword) {
+  const k = keyword.trim().toLowerCase().replace(/\s+/g, " ");
+  return k.length > 2 && k.endsWith("s") ? k.slice(0, -1) : k;
+}
+var cache = new Map;
+function adultPatterns(keywords) {
+  const stems = [...new Set((keywords ?? DEFAULT_ADULT_KEYWORDS2).map(stem))].filter((s) => s !== "").sort((a, b) => b.length - a.length || a.localeCompare(b));
+  const key = stems.join("\x00");
+  const hit = cache.get(key);
+  if (hit !== undefined)
+    return hit;
+  const adult = stems.includes(ADULT_STEM);
+  const words = stems.map((s) => s === ADULT_STEM ? "adults?|ad" : `${escape(s).replace(/ /g, "[\\s-]+")}s?`);
+  const one = words.length === 0 ? null : words.join("|");
+  const run = one === null ? null : `(?:${one})(?:[\\s-]+(?:${one}))*`;
+  const out = Object.freeze({ adult, one, run });
+  cache.set(key, out);
+  return out;
+}
+
 var LEAD_ID = /^\s*(?:comp(?:etition)?\.?\s*)?\d+[a-z]*(?:[/-]\d*[a-z]*)*\s*[-:.]?\s*/i;
 var PAREN = /\(([^)]*)\)/g;
 var AND_OVER = /(?<![0-9])(?<![0-9][a-z]*)(?<!(?:^|[^a-z0-9])[a-z])(\d{1,2})\s*(?:years?\s*)?(?:&|\+|\band\b)\s*(?:over|older|up|o)(?![a-z])/i;
@@ -27,7 +50,21 @@ var RANGE = new RegExp(String.raw`(?<![0-9])(?<![0-9][a-z]*)(?<!(?:^|[^a-z0-9])[
 var LEAD_RANGE = new RegExp(String.raw`^\s*([1-9]\d?)\s*${RANGE_DASH}\s*([1-9]\d?)(?![a-z0-9])(?!\s*[/&])`, "i");
 var ADULT_CODE = /^\s*a(?:(\d{1,2})(u|o|&o))?\s*$/i;
 var printsAdultCode2 = (phrase) => ADULT_CODE.test(phrase);
-var ADULT = /(?<!non[\s-])(?<!-)\b(?:adults?|advanced\s+adults?|masters?)\b/i;
+var adultTitleCache = new Map;
+function adultTitleWords(keywords) {
+  const p = adultPatterns(keywords);
+  const key = `${p.adult}\x00${p.one ?? ""}`;
+  const hit = adultTitleCache.get(key);
+  if (hit !== undefined)
+    return hit;
+  const one = p.one === null ? null : p.adult ? `advanced\\s+adults?|${p.one}` : p.one;
+  const out = Object.freeze({
+    word: one === null ? null : new RegExp(`(?<!non[\\s-])(?<!-)\\b(?:${one})\\b`, "i"),
+    code: p.adult
+  });
+  adultTitleCache.set(key, out);
+  return out;
+}
 var SENIOR = /(?<!-)\bseniors?\b/i;
 var TITLE_RANGE_MIN2 = 3;
 var TITLE_RANGE_MAX2 = 40;
@@ -59,7 +96,7 @@ function readJoined(title, s, offset) {
     return NONE;
   return at(title, offset, j.index, end, `u${Math.max(...caps)}`);
 }
-function readAnchored(title, s, offset, aside = false) {
+function readAnchored(title, s, offset, adultWord, aside = false) {
   const joined = readJoined(title, s, offset);
   if (joined !== null)
     return joined;
@@ -106,7 +143,7 @@ function readAnchored(title, s, offset, aside = false) {
   const p = OVER_PLUS.exec(s);
   if (p?.[1] !== undefined)
     return at(title, offset, p.index, p.index + p[0].length, `o${Number(p[1])}`);
-  const a = ADULT.exec(s);
+  const a = adultWord?.exec(s) ?? null;
   if (a !== null)
     return at(title, offset, a.index, a.index + a[0].length, "adult");
   const n = SENIOR.exec(s);
@@ -114,7 +151,8 @@ function readAnchored(title, s, offset, aside = false) {
     return at(title, offset, n.index, n.index + n[0].length, "senior");
   return NONE;
 }
-function ageTitleToken2(title) {
+function ageTitleToken2(title, options = {}) {
+  const aw = adultTitleWords(options.adultKeywords);
   const s = title.trim();
   if (s === "")
     return NONE;
@@ -127,7 +165,7 @@ function ageTitleToken2(title) {
     const from = lead + (m.index ?? 0) + 1;
     const i = m.index ?? 0;
     const tail = i + m[0].length === s.length && !/[a-z0-9]/i.test(s[i - 1] ?? "");
-    const code = tail ? ADULT_CODE.exec(inner) : null;
+    const code = tail && aw.code ? ADULT_CODE.exec(inner) : null;
     if (code !== null) {
       const split = code[1] === undefined ? "" : `${/u/i.test(code[2] ?? "") ? "u" : "o"}${code[1]}`;
       const a = inner.length - inner.trimStart().length;
@@ -136,19 +174,19 @@ function ageTitleToken2(title) {
     }
     if (adultWord !== null)
       continue;
-    const t = readAnchored(title, inner, from, true);
+    const t = readAnchored(title, inner, from, aw.word, true);
     if (t.token === "")
       continue;
     if (t.token === "adult") {
       adultWord = t;
       continue;
     }
-    return adultOverUnder(title, s, lead, t);
+    return adultOverUnder(title, s, lead, t, aw.word);
   }
   if (adultWord !== null)
     return adultAside ?? adultWord;
-  const words = readAnchored(title, s, lead);
-  return adultAside !== null && (words.token === "" || words.token === "adult") ? adultAside : adultOverUnder(title, s, lead, words);
+  const words = readAnchored(title, s, lead, aw.word);
+  return adultAside !== null && (words.token === "" || words.token === "adult") ? adultAside : adultOverUnder(title, s, lead, words, aw.word);
 }
 var ADULT_UNDER_MIN = 18;
 var SENIOR_ADULT_OVER = /\bsenior\s+adult\b/i;
@@ -172,10 +210,10 @@ function adultBeside2(band) {
     return band;
   return Number(floor) < ADULT_UNDER_MIN ? undefined : `adult ${b}`;
 }
-function adultOverUnder(title, s, lead, t) {
+function adultOverUnder(title, s, lead, t, adultWord) {
   if (t.token === "")
     return t;
-  const a = ADULT.exec(s);
+  const a = adultWord?.exec(s) ?? null;
   if (a === null)
     return t;
   if (/^o\d+$/.test(t.token) && SENIOR_ADULT_OVER.test(s))
@@ -206,9 +244,31 @@ var UNDER2 = /^(?:u|under\s*)(\d+)(?:\/([1-9]\d*)yr)?$/i;
 var OVER = /^(?:o|over\s*)(\d+)$/i;
 var AND_OVER2 = /^(\d+)\s*(?:&|and\b)\s*(?:over|o)$/i;
 var RANGE2 = /^u?(\d+)\s*[-–]\s*(\d+)$/i;
-var ADULT_WORD = /^(?:adults?|ad|advanced|masters?)$/i;
-var ADULT_UNDER = /^(?:adults?|ad)[\s-]*(?:u|under\s*)(\d+)(?:\/([1-9]\d*)yr)?$/i;
-var ADULT_BAND = /^(?:adults?|ad)[\s-]+(\S.*)$/i;
+var LEVEL_WORDS = "first[\\s-]*feis|(?:advanced[\\s-]+)?beginners?(?:[\\s-]*(?:1|2|i|ii))?|novice|prizewinners?|intermediate|advanced|open|prelim(?:inary)?|champions?(?:hip)?s?|champs?";
+var NO_ADULT_WORDS = Object.freeze({
+  word: null,
+  level: null,
+  under: null,
+  band: null
+});
+var adultWordsCache = new Map;
+function adultWordsOf(keywords) {
+  const p = adultPatterns(keywords);
+  if (p.run === null)
+    return NO_ADULT_WORDS;
+  const hit = adultWordsCache.get(p.run);
+  if (hit !== undefined)
+    return hit;
+  const run = p.run;
+  const out = Object.freeze({
+    word: new RegExp(`^(?:${run}${p.adult ? "|advanced" : ""})$`, "i"),
+    level: new RegExp(`^(?:(?:${LEVEL_WORDS})[\\s-]+(?:${run})|(?:${run})[\\s-]+(?:${LEVEL_WORDS}))$`, "i"),
+    under: new RegExp(`^(?:${run})[\\s-]*(?:u|under\\s*)(\\d+)(?:\\/([1-9]\\d*)yr)?$`, "i"),
+    band: new RegExp(`^(?:${run})[\\s-]+(\\S.*)$`, "i")
+  });
+  adultWordsCache.set(p.run, out);
+  return out;
+}
 var SENIOR_WORD = /^seniors?$/i;
 var NO_LADDER = Object.freeze({ caps: [], overs: [], ranges: [] });
 function maxWhere(xs, pred) {
@@ -270,11 +330,11 @@ function strideOf(k) {
   const n = Number(k);
   return Number.isInteger(n) && n >= 1 ? n : null;
 }
-function read(token, ladder, top) {
+function read(token, ladder, top, aw) {
   const r = RANGE2.exec(token);
   if (r !== null)
     return readRange(Number(r[1]), Number(r[2]), ladder);
-  const au = ADULT_UNDER.exec(token);
+  const au = aw.under?.exec(token) ?? null;
   if (au !== null && Number(au[1]) > ADULT_FLOOR2) {
     const k = strideOf(au[2]);
     const hi = Number(au[1]);
@@ -286,13 +346,13 @@ function read(token, ladder, top) {
       parts: k === null ? [hi] : [hi, k]
     };
   }
-  const ab = au === null ? ADULT_BAND.exec(token) : null;
+  const ab = au === null ? aw.band?.exec(token) ?? null : null;
   if (ab !== null) {
-    const inner = read(ab[1].trim(), { ...ladder, adult: true }, top);
+    const inner = read(ab[1].trim(), { ...ladder, adult: true }, top, aw);
     if (inner.kind === "over" || inner.kind === "range")
       return { ...inner, clauses: [...inner.clauses, "adult-band"], adult: true };
   }
-  if (au !== null || ADULT_WORD.test(token))
+  if (au !== null || aw.word?.test(token) === true || aw.level?.test(token) === true)
     return {
       kind: "adult",
       interval: { lo: ADULT_FLOOR2, hi: Number.POSITIVE_INFINITY },
@@ -394,7 +454,7 @@ function fromPrint(print, context = {}) {
   const ladder = context.ladder ?? NO_LADDER;
   const year = context.year === undefined ? currentYear() : context.year;
   const ag1 = print.trim().toLowerCase();
-  const reading = ag1 === "" ? { kind: null, interval: null, refusal: null, clauses: [], parts: [] } : refuseAboveOldest(refuseBelowYoungest(read(print.trim(), ladder, context.top === true)));
+  const reading = ag1 === "" ? { kind: null, interval: null, refusal: null, clauses: [], parts: [] } : refuseAboveOldest(refuseBelowYoungest(read(print.trim(), ladder, context.top === true, adultWordsOf(context.adultKeywords))));
   const iv = reading.interval;
   const arm = ag1 === "" ? "empty" : iv === null ? "open" : "band";
   const ag2 = iv !== null ? display(iv) : ag1 === "" ? "" : `${ag1}?`;
@@ -475,9 +535,11 @@ function fromYOB(from, to = from, context = {}) {
   });
 }
 function fromTitle(title, context = {}) {
-  const t = ageTitleToken2(title);
-  return Object.freeze({ age: fromPrint(t.token, context), token: t.token, span: t.span });
+  const t = ageTitleToken2(title, { adultKeywords: context.adultKeywords });
+  const age = fromPrint(t.token, { ...context, adultKeywords: TOKEN_ADULT_KEYWORDS });
+  return Object.freeze({ age, token: t.token, span: t.span });
 }
+var TOKEN_ADULT_KEYWORDS = Object.freeze(["adult"]);
 var Age2 = Object.freeze({ from: fromPrint, fromYOB, fromTitle });
 function sourceOf(r) {
   const iv = r.interval;
@@ -669,4 +731,4 @@ function youngFloor2(year, oldest) {
 var tooYoungForMajor2 = (year, oldest) => yearsSinceBirth2(year, oldest) < MIN_MAJOR_AGE2;
 var tooYoungForFeis2 = (year, oldest) => yearsSinceBirth2(year, oldest) < MIN_FEIS_AGE2;
 
-export { printsUnderOpen2, printsAdultCode2, TITLE_RANGE_MIN2, TITLE_RANGE_MAX2, ageTitleToken2, readsSeniorAdult2, adultBeside2, YOUNGEST_FLOOR2, ADULT_FLOOR2, MAJORS_FLOOR_YEARS2, UNDER_CAP2, UNDER_CAP_MAX_TOP2, YOUNG_FLOOR2, MIN_MAJOR_AGE2, MIN_FEIS_AGE2, YOUNGEST_BAND_TOP2, OLDEST_BAND_FLOOR2, YOB_RANGE2, DANCE_UP_YEARS2, ageOnJanuary12, yearsSinceBirth2, AgeMisuseError2, Age2, birthYearsOfInterval2, ageRelation2, canOverlap2, AVERAGE_AGE_DECIMALS2, roundedMeanHundredths2, isAveraged2, averageAge2, birthYearsDisjoint2, intersectBirthYears2, birthYearsMeet2, underCapApplies2, underCappedYears2, underCapRefuses2, validYOB2, youngFloor2, tooYoungForMajor2, tooYoungForFeis2 };
+export { DEFAULT_ADULT_KEYWORDS2, printsUnderOpen2, printsAdultCode2, TITLE_RANGE_MIN2, TITLE_RANGE_MAX2, ageTitleToken2, readsSeniorAdult2, adultBeside2, YOUNGEST_FLOOR2, ADULT_FLOOR2, MAJORS_FLOOR_YEARS2, UNDER_CAP2, UNDER_CAP_MAX_TOP2, YOUNG_FLOOR2, MIN_MAJOR_AGE2, MIN_FEIS_AGE2, YOUNGEST_BAND_TOP2, OLDEST_BAND_FLOOR2, YOB_RANGE2, DANCE_UP_YEARS2, ageOnJanuary12, yearsSinceBirth2, AgeMisuseError2, Age2, birthYearsOfInterval2, ageRelation2, canOverlap2, AVERAGE_AGE_DECIMALS2, roundedMeanHundredths2, isAveraged2, averageAge2, birthYearsDisjoint2, intersectBirthYears2, birthYearsMeet2, underCapApplies2, underCappedYears2, underCapRefuses2, validYOB2, youngFloor2, tooYoungForMajor2, tooYoungForFeis2 };

package/dist/code.js

@@ -0,0 +1,136 @@
+import {
+  Age2
+} from "./chunks/place-w6d4xfzc.js";
+import {
+  populationIn2,
+  compTitle2
+} from "./chunks/place-dn6qk21g.js";
+import {
+  validity
+} from "./chunks/place-q9kwsmzd.js";
+
+var TRAILING = /(?:-[A-Za-z0-9]+|\[[A-Za-z0-9]+\])$/;
+var GROUP = /^([1-7])(\d{2})([A-Za-z]+?)2?$/;
+var OFF_LADDER = new Set(["TR", "TS", "SD", "FD", "FC"]);
+function group(print) {
+  let s = print.trim();
+  let male = false;
+  let female = false;
+  for (let m = TRAILING.exec(s);m !== null; m = TRAILING.exec(s)) {
+    const t = m[0].toUpperCase();
+    if (t === "-M" || t === "[M]")
+      male = true;
+    if (t === "-F" || t === "[F]")
+      female = true;
+    s = s.slice(0, m.index);
+  }
+  const g = GROUP.exec(s);
+  if (g === null)
+    return null;
+  const mm = Number(g[2]);
+  const plus50 = mm >= 50 && mm <= 89;
+  return {
+    digit: g[1],
+    letters: g[3].toUpperCase(),
+    column: mm === 99 ? null : plus50 ? mm - 50 : mm,
+    boys: plus50 || male,
+    girls: female
+  };
+}
+function groups(print) {
+  const out = [];
+  for (const part of print.split("/")) {
+    const g = group(part);
+    if (g === null)
+      return null;
+    out.push(g);
+  }
+  return out.length === 0 ? null : out;
+}
+function decode(print, year, codes) {
+  const gs = groups(print);
+  if (gs === null)
+    return null;
+  const first = gs[0];
+  if (gs.some((g) => g.digit !== first.digit))
+    return null;
+  const adult = gs.filter((g) => g.column === null).length;
+  if (adult > 0 && adult < gs.length)
+    return null;
+  const level = OFF_LADDER.has(first.letters) ? null : Number(first.digit) * 100;
+  const others = codes === null ? [] : codes.flatMap((c) => groups(c) ?? []);
+  const boys = gs.every((g) => g.boys);
+  const split = others.some((g) => g.digit === first.digit && g.boys);
+  const population = gs.some((g) => g.boys) && !boys ? "mixed" : boys ? "boys" : codes === null ? "" : split || first.girls && others.some((g) => g.boys) ? "girls" : "mixed";
+  if (adult > 0)
+    return { age: Age2.from("Adult", { year }), level, population };
+  const cols = gs.map((g) => g.column);
+  const lo = Math.min(...cols);
+  const hi = Math.max(...cols);
+  const series = others.filter((g) => g.digit === first.digit && g.letters === first.letters && g.boys === boys);
+  const offered = series.map((g) => g.column).filter((c) => c !== null);
+  const top = offered.length > 1 && hi >= Math.max(...offered);
+  const band = top ? `O${lo - 1}` : lo === hi ? `U${hi}` : `U${hi}/${hi - lo + 1}yr`;
+  return { age: Age2.from(band, { year }), level, population };
+}
+var foldCode = (code) => code.trim().toUpperCase();
+var NO_AGE = Age2.from("", { year: null });
+function createCodeReader(options = {}) {
+  const standardized = new Set([...options.standardized ?? []].map((p) => p.trim().toLowerCase()));
+  const scheme = (platform) => standardized.has(platform.trim().toLowerCase()) ? "standardized" : "feis-specific";
+  function read(code, ctx) {
+    const s = scheme(ctx.platform);
+    const feis = (ctx.feis ?? "").trim() === "" ? null : ctx.feis.trim();
+    const year = ctx.year ?? null;
+    const make = (refusal, source, age, level, population, entry) => {
+      const v = validity(code.trim() === "", refusal);
+      return Object.freeze({
+        [Symbol.toStringTag]: "CompCode",
+        ...v,
+        print: code,
+        platform: ctx.platform,
+        feis,
+        scheme: s,
+        source: v.isValid() ? source : null,
+        age: v.isValid() ? age : NO_AGE,
+        level: v.isValid() ? level : null,
+        population: v.isValid() ? population : "",
+        entry: v.isValid() ? entry : null,
+        isComp: () => v.isValid() && age.isAge()
+      });
+    };
+    const refuse = (r) => make(r, null, NO_AGE, null, "", null);
+    if (code.trim() === "")
+      return refuse("not-a-code");
+    if (feis === null)
+      return refuse("no-feis");
+    const codes = ctx.codes === undefined ? null : [...ctx.codes];
+    if (ctx.syllabus !== undefined && ctx.syllabus.length > 0) {
+      const hits = ctx.syllabus.filter((e) => foldCode(e.code) === foldCode(code));
+      if (hits.length === 0)
+        return refuse("not-in-syllabus");
+      if (hits.length > 1)
+        return refuse("two-entries");
+      const e = hits[0];
+      const printed = e.age !== undefined && e.age.trim() !== "" ? Age2.from(e.age, { year }) : null;
+      const age = printed?.isAge() === true ? printed : compTitle2(e.title, { year }).age;
+      return make(null, "syllabus", age, null, populationIn2(e.title), e);
+    }
+    if (s === "feis-specific")
+      return refuse("feis-specific");
+    const decoded = decode(code, year, codes);
+    if (decoded === null || !decoded.age.isAge())
+      return refuse("not-a-code");
+    return make(null, "code", decoded.age, decoded.level, decoded.population, null);
+  }
+  return Object.freeze({ scheme, read });
+}
+var DEFAULT_CODE_READER = createCodeReader();
+function compCode(code, ctx) {
+  return DEFAULT_CODE_READER.read(code, ctx);
+}
+export {
+  DEFAULT_CODE_READER,
+  compCode,
+  createCodeReader
+};

package/dist/schedule.js

@@ -1,8 +1,8 @@
-import"./chunks/place-kmh59zkw.js";
+import"./chunks/place-w6d4xfzc.js";
 import {
   compTitle2,
   matchTitle2
-} from "./chunks/place-7jfd4m3j.js";
+} from "./chunks/place-dn6qk21g.js";
 
 function hallKey(hall) {
   return hall.normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();

package/dist/title.js

@@ -9,8 +9,8 @@ import {
   titleRelation2,
   ladderOf2,
   matchTitle2
-} from "./chunks/place-7jfd4m3j.js";
-import"./chunks/place-kmh59zkw.js";
+} from "./chunks/place-dn6qk21g.js";
+import"./chunks/place-w6d4xfzc.js";
 export {
   codePopulation2 as codePopulation,
   compTitle2 as compTitle,

package/dist/types/adult-keywords.d.ts

@@ -0,0 +1,7 @@
+export declare const DEFAULT_ADULT_KEYWORDS: readonly string[];
+export interface AdultPatterns {
+    readonly adult: boolean;
+    readonly one: string | null;
+    readonly run: string | null;
+}
+export declare function adultPatterns(keywords: readonly string[] | undefined): AdultPatterns;

package/dist/types/age-title.d.ts

@@ -1,5 +1,8 @@
 export declare const printsUnderOpen: (print: string) => boolean;
 export declare const printsAdultCode: (phrase: string) => boolean;
+export interface AgeTitleOptions {
+    readonly adultKeywords?: readonly string[];
+}
 export declare const TITLE_RANGE_MIN = 3;
 export declare const TITLE_RANGE_MAX = 40;
 export interface AgeTitleSpan {
@@ -11,6 +14,6 @@ export interface AgeTitleToken {
     readonly token: string;
     readonly span: AgeTitleSpan | null;
 }
-export declare function ageTitleToken(title: string): AgeTitleToken;
+export declare function ageTitleToken(title: string, options?: AgeTitleOptions): AgeTitleToken;
 export declare function readsSeniorAdult(title: string, span: AgeTitleSpan): boolean;
 export declare function adultBeside(band: string): string | undefined;

package/dist/types/age-types.d.ts

@@ -20,6 +20,7 @@ export interface AgeContext {
     readonly ladder?: AgeLadder;
     readonly year?: number | null;
     readonly top?: boolean;
+    readonly adultKeywords?: readonly string[];
 }
 export type AgeArm = "band" | "yob" | "open" | "empty";
 export type AgeKind = "under" | "over" | "range" | "adult" | "senior" | "yob";

package/dist/types/age.d.ts

@@ -1,7 +1,8 @@
 import { type AgeTitleSpan } from "./age-title.ts";
 import type { AgeArm, AgeClause, AgeComparison, AgeContext, AgeInterval, AgeKind, AgeLadder, AgeMisuse, AgeRefusal, AgeRelation, AgeRelationReason, AgeSource, AgeSpan, BirthYears, YOBContext, YoungFloorVerdict } from "./age-types.ts";
 import { type EmptyReason, type Validated } from "./validated.ts";
-export { type AgeTitleSpan, type AgeTitleToken, TITLE_RANGE_MAX, TITLE_RANGE_MIN, adultBeside, ageTitleToken, printsAdultCode, printsUnderOpen, readsSeniorAdult, } from "./age-title.ts";
+export { DEFAULT_ADULT_KEYWORDS } from "./adult-keywords.ts";
+export { type AgeTitleOptions, type AgeTitleSpan, type AgeTitleToken, TITLE_RANGE_MAX, TITLE_RANGE_MIN, adultBeside, ageTitleToken, printsAdultCode, printsUnderOpen, readsSeniorAdult, } from "./age-title.ts";
 export type { AgeArm, AgeClause, AgeComparison, AgeContext, AgeInterval, AgeKind, AgeLadder, AgeMisuse, AgeRefusal, AgeRelation, AgeRelationReason, AgeSource, AgeSpan, BirthYears, EmptyReason, Validated, YOBContext, YoungFloorVerdict, };
 export declare const YOUNGEST_FLOOR = 0;
 export declare const ADULT_FLOOR = 18;

package/dist/types/code.d.ts

@@ -0,0 +1,41 @@
+import { Age } from "./age.ts";
+import { type Population } from "./title.ts";
+import { type Validated } from "./validated.ts";
+export type { EmptyReason, Validated } from "./validated.ts";
+export type CodeScheme = "standardized" | "feis-specific";
+export type CodeRefusal = "no-feis" | "feis-specific" | "not-in-syllabus" | "two-entries" | "not-a-code";
+export interface CodeEntry {
+    readonly code: string;
+    readonly title: string;
+    readonly age?: string;
+}
+export interface CodeContext<E extends CodeEntry = CodeEntry> {
+    readonly platform: string;
+    readonly feis: string | null | undefined;
+    readonly year?: number | null;
+    readonly syllabus?: readonly E[];
+    readonly codes?: Iterable<string>;
+}
+export interface CompCode<E extends CodeEntry = CodeEntry> extends Validated<CodeRefusal> {
+    readonly [Symbol.toStringTag]: "CompCode";
+    readonly print: string;
+    readonly platform: string;
+    readonly feis: string | null;
+    readonly scheme: CodeScheme;
+    readonly source: "syllabus" | "code" | null;
+    readonly age: Age;
+    readonly level: number | null;
+    readonly population: Population | "";
+    readonly entry: E | null;
+    isComp(): boolean;
+}
+export interface CodeReaderOptions {
+    readonly standardized?: Iterable<string>;
+}
+export interface CodeReader {
+    scheme(platform: string): CodeScheme;
+    read<E extends CodeEntry>(code: string, ctx: CodeContext<E>): CompCode<E>;
+}
+export declare function createCodeReader(options?: CodeReaderOptions): CodeReader;
+export declare const DEFAULT_CODE_READER: CodeReader;
+export declare function compCode<E extends CodeEntry>(code: string, ctx: CodeContext<E>): CompCode<E>;

package/dist/types/title.d.ts

@@ -12,6 +12,7 @@ export declare function roundFold(print: string): string;
 export interface TitleContext {
     readonly year?: number | null;
     readonly ladder?: AgeLadder;
+    readonly adultKeywords?: readonly string[];
 }
 export type TitleRefusal = "no-age";
 export interface CompTitle extends Validated<TitleRefusal> {

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@finbheara/domain",
-	"version": "0.50.0",
-	"description": "Places, CLRG regions, school names, ages, dances, competition titles and schedules, and a person's print in its role, as they are printed: read, compared and told apart",
+	"version": "0.52.0",
+	"description": "Places, CLRG regions, school names, ages, dances, competition titles, codes and schedules, and a person's print in its role, as they are printed: read, compared and told apart",
 	"keywords": [
 		"places",
 		"regions",
@@ -73,6 +73,10 @@
 			"types": "./dist/types/schedule.d.ts",
 			"default": "./dist/schedule.js"
 		},
+		"./code": {
+			"types": "./dist/types/code.d.ts",
+			"default": "./dist/code.js"
+		},
 		"./package.json": "./package.json"
 	},
 	"files": ["dist/*.js", "dist/chunks/*.js", "dist/types/**/*.d.ts", "README.md", "LICENSE"],
@@ -89,7 +93,7 @@
 		"prepublishOnly": "bun scripts/build.ts && bun scripts/guard-tarball.ts"
 	},
 	"dependencies": {
-		"@finbheara/names": "0.23.0"
+		"@finbheara/names": "0.25.0"
 	},
 	"devDependencies": {
 		"typescript": "7.0.2"