@finbheara/domain 0.52.0 → 0.54.0

package/README.md

@@ -7,6 +7,8 @@ person names.
 
 - **Places**: a print in, the set of place-tree nodes it may mean out. A country, a state or
   province, a county, a city, or a CLRG region, with a relation between any two readings.
+- **CLRG events**: the Worlds, the nationals and the regional Oireachtais by event code, with
+  tier, canonical name, jurisdiction and North American eligibility.
 - **CLRG regions**: the CLRG's dance regions and their Oireachtas codes, and the region a
   location phrase falls in.
 - **School names**: a printed school name in, a `SchoolName` out, with a display form, a
@@ -40,13 +42,14 @@ ESM, Node ≥ 22 or Bun ≥ 1.4.2. MIT. Not affiliated with or endorsed by any d
 | `@finbheara/domain/place` | `place()`, `createPlaceReader`, `placeRelation`, the `Place` types |
 | `@finbheara/domain/geocode` | `geocode()`: a location field read by the place store, then by every GeoNames town of AU, CA, GB, IE, NZ and US; `townCell` |
 | `@finbheara/domain/clrg-regions` | `REGIONS`, `regionOf`, `resolvePhrase` |
+| `@finbheara/domain/event` | `EVENT_REGISTER`, `EVENT_REGISTER_BY_CODE`, `EVENT_TIER`, `eventTier`, `isMajorEvent`, `eventCodeOfSlug`, the `EventRegisterRow` type: the CLRG championships of tier 1 to 3 (below) |
 | `@finbheara/domain/school` | `createSchoolNameReader`, `DEFAULT_SCHOOL_NAME_READER`, `compareSchoolNames`, `foldSchoolName`, `schoolEncoder`, `schoolColumns` |
 | `@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`, `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/dance-types` | `danceTypes()`, `DANCE_TYPES`, `GRADE_DANCES` and `isGradeDance()` (the six solo dances a grade is held in, per dance), `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) |
@@ -181,6 +184,21 @@ A region is always the CLRG council that runs a place, and never its province or
 the two differ. County Louth lies in the province of Leinster and is run by the Ulster council,
 so it reads `ULSTER`, as Northern Ireland reads `ULSTER` and Wales `ENG_MIDLANDS`.
 
+## Look up a CLRG event
+
+```ts
+import { EVENT_REGISTER_BY_CODE, eventCodeOfSlug, eventTier, isMajorEvent } from "@finbheara/domain/event";
+
+EVENT_REGISTER_BY_CODE.get("sro")?.canonicalName;  // "Southern Region Oireachtas"
+eventTier("naidc");                                // 2
+isMajorEvent("bucharest");                         // false: a local feis has no row
+eventCodeOfSlug("naidc2024.514tsb");               // "naidc"
+```
+
+The register carries the Worlds (tier 1), the nationals (2) and the regional Oireachtais (3),
+in that order. It is complete for those tiers and silent below: a code it does not carry is a
+local event or no event code, and `eventTier` answers `null` for both rather than a guess.
+
 ## Read a school name
 
 ```ts

package/dist/ceili.js

@@ -4,8 +4,8 @@ import {
   ceiliById2,
   ceili2,
   ceiliRelation2
-} from "./chunks/place-gd57gavk.js";
-import"./chunks/place-ng98cts4.js";
+} from "./chunks/place-3xxgddqw.js";
+import"./chunks/place-3pgn1jgx.js";
 export {
   CEILI_NODES2 as CEILI_NODES,
   allCeilis2 as allCeilis,

package/dist/chunks/{place-ng98cts4.js → place-3pgn1jgx.js}

@@ -99,6 +99,18 @@ var DANCE_TYPES2 = Object.freeze([
   "traditional-set",
   "set-dance"
 ]);
+var GRADE_DANCES2 = Object.freeze([
+  "reel",
+  "light-jig",
+  "single-jig",
+  "slip-jig",
+  "treble-jig",
+  "hornpipe"
+]);
+var GRADED = new Set(GRADE_DANCES2);
+function isGradeDance2(d) {
+  return d != null && GRADED.has(d);
+}
 function rhythmOfTime2(time) {
   return time === "2/4" || time === "4/4" ? "hornpipe" : "jig";
 }
@@ -138,4 +150,4 @@ function isDanceTypePrint2(print) {
   return danceTypes2(print).length > 0;
 }
 
-export { foldDancePrint, splitTempo, matchNodes, candidateRelation, DANCE_TYPES2, rhythmOfTime2, danceTypes2, danceTypePrints2, isDanceTypePrint2 };
+export { foldDancePrint, splitTempo, matchNodes, candidateRelation, DANCE_TYPES2, GRADE_DANCES2, isGradeDance2, rhythmOfTime2, danceTypes2, danceTypePrints2, isDanceTypePrint2 };

package/dist/chunks/{place-gd57gavk.js → place-3xxgddqw.js}

@@ -3,7 +3,7 @@ import {
   matchNodes,
   candidateRelation,
   isDanceTypePrint2
-} from "./place-ng98cts4.js";
+} from "./place-3pgn1jgx.js";
 import {
   validity
 } from "./place-q9kwsmzd.js";

package/dist/chunks/{place-tpj00cfp.js → place-4gycgaw0.js}

@@ -5,7 +5,7 @@ import {
   candidateRelation,
   rhythmOfTime2,
   isDanceTypePrint2
-} from "./place-ng98cts4.js";
+} from "./place-3pgn1jgx.js";
 import {
   validity
 } from "./place-q9kwsmzd.js";

package/dist/dance-types.js

@@ -1,14 +1,18 @@
 import {
   DANCE_TYPES2,
+  GRADE_DANCES2,
+  isGradeDance2,
   rhythmOfTime2,
   danceTypes2,
   danceTypePrints2,
   isDanceTypePrint2
-} from "./chunks/place-ng98cts4.js";
+} from "./chunks/place-3pgn1jgx.js";
 export {
   DANCE_TYPES2 as DANCE_TYPES,
+  GRADE_DANCES2 as GRADE_DANCES,
   danceTypePrints2 as danceTypePrints,
   danceTypes2 as danceTypes,
   isDanceTypePrint2 as isDanceTypePrint,
+  isGradeDance2 as isGradeDance,
   rhythmOfTime2 as rhythmOfTime
 };

package/dist/dance.js

@@ -1,10 +1,10 @@
-import"./chunks/place-ng98cts4.js";
+import"./chunks/place-3pgn1jgx.js";
 import {
   ceili2
-} from "./chunks/place-gd57gavk.js";
+} from "./chunks/place-3xxgddqw.js";
 import {
   tune2
-} from "./chunks/place-tpj00cfp.js";
+} from "./chunks/place-4gycgaw0.js";
 import {
   validity
 } from "./chunks/place-q9kwsmzd.js";

package/dist/event.js

@@ -0,0 +1,231 @@
+var EVENT_REGISTER = [
+  {
+    code: "ornc",
+    canonicalName: "Oireachtas Rince na Cruinne — Worlds",
+    tier: 1,
+    jurisdiction: "Global (target)",
+    naEligible: null
+  },
+  {
+    code: "ornh",
+    canonicalName: "Oireachtas Rince na hÉireann — All-Irelands",
+    tier: 2,
+    jurisdiction: "Ireland",
+    naEligible: false
+  },
+  {
+    code: "crn",
+    canonicalName: "Craobhacha Rince Náisiúnta — Irish Nationals",
+    tier: 2,
+    jurisdiction: "Ireland",
+    naEligible: false
+  },
+  {
+    code: "naidc",
+    canonicalName: "North American Nationals",
+    tier: 2,
+    jurisdiction: "IDTANA",
+    naEligible: true
+  },
+  {
+    code: "cnidc",
+    canonicalName: "Canadian National Irish Dance Championships",
+    tier: 2,
+    jurisdiction: "IDTANA (Can)",
+    naEligible: false
+  },
+  {
+    code: "gbc",
+    canonicalName: "Great Britain Championships",
+    tier: 2,
+    jurisdiction: "GB",
+    naEligible: false
+  },
+  {
+    code: "asc",
+    canonicalName: "All-Scotland Championships",
+    tier: 2,
+    jurisdiction: "Scotland",
+    naEligible: false
+  },
+  {
+    code: "brnat",
+    canonicalName: "British National Championships",
+    tier: 2,
+    jurisdiction: "GB",
+    naEligible: false
+  },
+  {
+    code: "nero",
+    canonicalName: "New England Region Oireachtas",
+    tier: 3,
+    jurisdiction: "IDTANA (US)",
+    naEligible: true
+  },
+  {
+    code: "maro",
+    canonicalName: "Mid-Atlantic Region Oireachtas",
+    tier: 3,
+    jurisdiction: "IDTANA (US)",
+    naEligible: true
+  },
+  {
+    code: "sro",
+    canonicalName: "Southern Region Oireachtas",
+    tier: 3,
+    jurisdiction: "IDTANA (US)",
+    naEligible: true
+  },
+  {
+    code: "mao",
+    canonicalName: "Mid-America Oireachtas",
+    tier: 3,
+    jurisdiction: "IDTANA (US)",
+    naEligible: true
+  },
+  {
+    code: "wusro",
+    canonicalName: "Western US Region Oireachtas",
+    tier: 3,
+    jurisdiction: "IDTANA (US)",
+    naEligible: true
+  },
+  {
+    code: "ecro",
+    canonicalName: "Eastern Canadian Oireachtas",
+    tier: 3,
+    jurisdiction: "IDTANA (Can)",
+    naEligible: true
+  },
+  {
+    code: "wcro",
+    canonicalName: "Western Canadian Region Oireachtas",
+    tier: 3,
+    jurisdiction: "IDTANA (Can)",
+    naEligible: true
+  },
+  {
+    code: "orl",
+    canonicalName: "Oir. Rince Laighean — Leinster",
+    tier: 3,
+    jurisdiction: "Ireland",
+    naEligible: false
+  },
+  {
+    code: "orm",
+    canonicalName: "Oir. Rince na Mumhan — Munster",
+    tier: 3,
+    jurisdiction: "Ireland",
+    naEligible: false
+  },
+  {
+    code: "oru",
+    canonicalName: "Oir. Rince Uladh — Ulster",
+    tier: 3,
+    jurisdiction: "Ireland",
+    naEligible: false
+  },
+  {
+    code: "orc",
+    canonicalName: "Oir. Rince Chonnacht — Connacht",
+    tier: 3,
+    jurisdiction: "Ireland",
+    naEligible: false
+  },
+  {
+    code: "sno",
+    canonicalName: "Scottish National Oireachtas",
+    tier: 3,
+    jurisdiction: "GB",
+    naEligible: false
+  },
+  {
+    code: "emid",
+    canonicalName: "England-Midlands (Lár na Breataine)",
+    tier: 3,
+    jurisdiction: "GB",
+    naEligible: false
+  },
+  {
+    code: "enw",
+    canonicalName: "England-North-West Oireachtas (NWRC)",
+    tier: 3,
+    jurisdiction: "GB",
+    naEligible: false
+  },
+  {
+    code: "ene",
+    canonicalName: "North East England Regional Oireachtas",
+    tier: 3,
+    jurisdiction: "GB",
+    naEligible: false
+  },
+  {
+    code: "seo",
+    canonicalName: "Southern England Oireachtas",
+    tier: 3,
+    jurisdiction: "GB",
+    naEligible: false
+  },
+  {
+    code: "rccea",
+    canonicalName: "Continental Europe & Asia Oireachtas",
+    tier: 3,
+    jurisdiction: "RCCEA",
+    naEligible: false
+  },
+  {
+    code: "tida",
+    canonicalName: "New Zealand National Championships",
+    tier: 2,
+    jurisdiction: "NZ",
+    naEligible: false
+  },
+  {
+    code: "aidc",
+    canonicalName: "Australian National Championships",
+    tier: 2,
+    jurisdiction: "Australia",
+    naEligible: false
+  },
+  {
+    code: "aio",
+    canonicalName: "Australian International Oireachtas",
+    tier: 2,
+    jurisdiction: "Australia",
+    naEligible: false
+  },
+  {
+    code: "rsa",
+    canonicalName: "South Africa Oireachtas",
+    tier: 3,
+    jurisdiction: "South Africa",
+    naEligible: false
+  },
+  {
+    code: "orsam",
+    canonicalName: "Oir. Rince An Meiriceá Theas — S. America",
+    tier: 3,
+    jurisdiction: "South America",
+    naEligible: false
+  }
+];
+var EVENT_REGISTER_BY_CODE = new Map(EVENT_REGISTER.map((r) => [r.code, r]));
+var EVENT_TIER = new Map(EVENT_REGISTER.map((r) => [r.code, r.tier]));
+function eventTier(code) {
+  return EVENT_TIER.get(code) ?? null;
+}
+function isMajorEvent(code) {
+  return EVENT_TIER.has(code);
+}
+function eventCodeOfSlug(slug) {
+  return /^([a-z]+)\d{4}(?:[.\-]|$)/.exec(slug)?.[1] ?? null;
+}
+export {
+  EVENT_REGISTER,
+  EVENT_REGISTER_BY_CODE,
+  EVENT_TIER,
+  eventCodeOfSlug,
+  eventTier,
+  isMajorEvent
+};

package/dist/tune.js

@@ -8,8 +8,8 @@ import {
   settingAt2,
   tune2,
   tuneRelation2
-} from "./chunks/place-tpj00cfp.js";
-import"./chunks/place-ng98cts4.js";
+} from "./chunks/place-4gycgaw0.js";
+import"./chunks/place-3pgn1jgx.js";
 export {
   PLAUSIBLE_SET_TEMPO_MAX2 as PLAUSIBLE_SET_TEMPO_MAX,
   SET_MIN_SPEED2 as SET_MIN_SPEED,

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

@@ -1,6 +1,9 @@
 export type { DanceMatch, DanceRelation } from "./dance-match.ts";
 export type DanceType = "reel" | "light-jig" | "single-jig" | "slip-jig" | "treble-jig" | "hornpipe" | "traditional-set" | "set-dance";
 export declare const DANCE_TYPES: readonly DanceType[];
+export type GradeDance = Exclude<DanceType, "traditional-set" | "set-dance">;
+export declare const GRADE_DANCES: readonly GradeDance[];
+export declare function isGradeDance(d: string | null | undefined): d is GradeDance;
 export type TimeSignature = "2/4" | "4/4" | "6/8" | "9/8" | "6/8+9/8";
 export type SetRhythm = "jig" | "hornpipe";
 export declare function rhythmOfTime(time: TimeSignature): SetRhythm;

package/dist/types/event.d.ts

@@ -0,0 +1,13 @@
+export interface EventRegisterRow {
+    code: string;
+    canonicalName: string;
+    tier: 1 | 2 | 3;
+    jurisdiction: string;
+    naEligible: boolean | null;
+}
+export declare const EVENT_REGISTER: readonly EventRegisterRow[];
+export declare const EVENT_REGISTER_BY_CODE: ReadonlyMap<string, EventRegisterRow>;
+export declare const EVENT_TIER: ReadonlyMap<string, 1 | 2 | 3>;
+export declare function eventTier(code: string): 1 | 2 | 3 | null;
+export declare function isMajorEvent(code: string): boolean;
+export declare function eventCodeOfSlug(slug: string): string | null;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@finbheara/domain",
-	"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",
+	"version": "0.54.0",
+	"description": "Places, CLRG regions and events, 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",
@@ -77,6 +77,10 @@
 			"types": "./dist/types/code.d.ts",
 			"default": "./dist/code.js"
 		},
+		"./event": {
+			"types": "./dist/types/event.d.ts",
+			"default": "./dist/event.js"
+		},
 		"./package.json": "./package.json"
 	},
 	"files": ["dist/*.js", "dist/chunks/*.js", "dist/types/**/*.d.ts", "README.md", "LICENSE"],
@@ -93,7 +97,7 @@
 		"prepublishOnly": "bun scripts/build.ts && bun scripts/guard-tarball.ts"
 	},
 	"dependencies": {
-		"@finbheara/names": "0.25.0"
+		"@finbheara/names": "0.26.0"
 	},
 	"devDependencies": {
 		"typescript": "7.0.2"