colregs 0.1.0 → 0.2.0

package/data/geometry.json

@@ -1,15 +1,15 @@
 {
- "ruleset": "international",
+ "jurisdiction": "intl",
  "source": "Annex I - Positioning and Technical Details of Lights and Shapes (33 CFR 84), International text",
  "note": "The structured half of the image payload: where each light sits and what it looks like, so a renderer can draw a configuration instead of picking a scan. Bearing arcs live in lights.json; this file carries heights, spacings, colour and intensity.",
  "vertical_positioning": [
   {
    "cite": "AnxI.2(a)(i)",
-   "light": "masthead",
+   "light": "light:masthead",
    "which": "forward (or the only one)",
    "when": {
-    "propulsion": "power",
-    "length_m": {
+    "fact:propulsion": "propulsion:power",
+    "fact:length_m": {
      "gte": 20
     }
    },
@@ -21,11 +21,11 @@
   },
   {
    "cite": "AnxI.2(a)(ii)",
-   "light": "masthead",
+   "light": "light:masthead",
    "which": "after",
    "when": {
-    "propulsion": "power",
-    "length_m": {
+    "fact:propulsion": "propulsion:power",
+    "fact:length_m": {
      "gte": 20
     }
    },
@@ -35,16 +35,16 @@
   },
   {
    "cite": "AnxI.2(b)",
-   "light": "masthead",
+   "light": "light:masthead",
    "constraint": "separation",
    "text": "The vertical separation of the masthead lights of power-driven vessels shall be such that in all normal conditions of trim the after light will be seen over and separate from the forward light at a distance of 1000 meters from the stem when viewed from sea level."
   },
   {
    "cite": "AnxI.2(c)",
-   "light": "masthead",
+   "light": "light:masthead",
    "when": {
-    "propulsion": "power",
-    "length_m": {
+    "fact:propulsion": "propulsion:power",
+    "fact:length_m": {
      "gte": 12,
      "lt": 20
     }
@@ -55,10 +55,10 @@
   },
   {
    "cite": "AnxI.2(d)",
-   "light": "masthead",
+   "light": "light:masthead",
    "when": {
-    "propulsion": "power",
-    "length_m": {
+    "fact:propulsion": "propulsion:power",
+    "fact:length_m": {
      "lt": 12
     }
    },
@@ -71,11 +71,11 @@
   },
   {
    "cite": "AnxI.2(e)",
-   "light": "masthead",
+   "light": "light:masthead",
    "when": {
-    "activity": [
-     "towing",
-     "pushing"
+    "fact:activity": [
+     "activity:towing",
+     "activity:pushing"
     ]
    },
    "datum": "forward masthead light",
@@ -84,13 +84,13 @@
   },
   {
    "cite": "AnxI.2(f)(i)",
-   "light": "masthead",
+   "light": "light:masthead",
    "constraint": "clearance",
    "text": "The masthead lights or lights prescribed in Rule 23(a) shall be so placed as to be above and clear of all other lights and obstructions except as described in paragraph (f)(ii)."
   },
   {
    "cite": "AnxI.2(f)(ii)",
-   "light": "all_round",
+   "light": "light:all_round",
    "applies_to_entries": [
     "27b-id",
     "28"
@@ -99,9 +99,9 @@
   },
   {
    "cite": "AnxI.2(g)",
-   "light": "sidelights",
+   "light": "light:sidelights",
    "when": {
-    "propulsion": "power"
+    "fact:propulsion": "propulsion:power"
    },
    "datum": "forward masthead light",
    "max_fraction_of_masthead_height": 0.75,
@@ -109,11 +109,11 @@
   },
   {
    "cite": "AnxI.2(h)",
-   "light": "sidelights",
+   "light": "light:sidelights",
    "combined": true,
    "when": {
-    "propulsion": "power",
-    "length_m": {
+    "fact:propulsion": "propulsion:power",
+    "fact:length_m": {
      "lt": 20
     }
    },
@@ -125,7 +125,7 @@
    "cite": "AnxI.2(i)(i)",
    "constraint": "vertical line spacing",
    "when": {
-    "length_m": {
+    "fact:length_m": {
      "gte": 20
     }
    },
@@ -141,7 +141,7 @@
    "cite": "AnxI.2(i)(ii)",
    "constraint": "vertical line spacing",
    "when": {
-    "length_m": {
+    "fact:length_m": {
      "lt": 20
     }
    },
@@ -178,7 +178,7 @@
    "min_m": 4.5,
    "also": {
     "when": {
-     "length_m": {
+     "fact:length_m": {
       "gte": 50
      }
     },
@@ -191,7 +191,7 @@
  "horizontal_positioning": [
   {
    "cite": "AnxI.3(a)",
-   "light": "masthead",
+   "light": "light:masthead",
    "constraint": "separation",
    "min_fraction_of_length": 0.25,
    "need_not_exceed_m": 50,
@@ -200,10 +200,10 @@
   },
   {
    "cite": "AnxI.3(b)",
-   "light": "sidelights",
+   "light": "light:sidelights",
    "when": {
-    "propulsion": "power",
-    "length_m": {
+    "fact:propulsion": "propulsion:power",
+    "fact:length_m": {
      "gte": 20
     }
    },
@@ -219,7 +219,7 @@
   },
   {
    "cite": "AnxI.3(d)",
-   "light": "masthead",
+   "light": "light:masthead",
    "text": "When only one masthead light is prescribed for a power-driven vessel, this light shall be exhibited forward of amidships. For a vessel of less than 20 meters in length, the vessel shall exhibit one masthead light as far forward as is practicable."
   }
  ],
@@ -272,7 +272,7 @@
   "vertical_spacing_min_m": 1.5,
   "small_vessel_relief": {
    "when": {
-    "length_m": {
+    "fact:length_m": {
      "lt": 20
     }
    },

package/data/images.json

@@ -780,7 +780,7 @@
     "30(d)"
    ],
    "entries": [
-    "30d"
+    "30d-red"
    ]
   },
   "NRHB_30_dii.png": {
@@ -810,11 +810,16 @@
     225,
     325
    ],
-   "source_url": null,
-   "source": "carried over from mark-brannan/signalk-auto-nav-lights images/; believed USCG, original page not located",
-   "retrieved": "2026-08-29",
-   "rights": "unverified - see PROVENANCE.md",
-   "provenance_status": "unresolved"
+   "source_url": "https://www.navcen.uscg.gov/sites/default/files/images/nr_pics/Arcs/mastheadarc.gif",
+   "source": "USCG Navigation Center, Navigation Rules Arcs of Visibility (https://www.navcen.uscg.gov/navigation-rules-arcs-of-visibility)",
+   "retrieved": "2026-09-05",
+   "rights": "US Government work, public domain (17 U.S.C. 105)",
+   "captions": [
+    "Masthead Light"
+   ],
+   "paragraphs": [
+    "21(a)"
+   ]
   },
   "portarc.gif": {
    "file": "portarc.gif",
@@ -824,11 +829,16 @@
     225,
     325
    ],
-   "source_url": null,
-   "source": "carried over from mark-brannan/signalk-auto-nav-lights images/; believed USCG, original page not located",
-   "retrieved": "2026-08-29",
-   "rights": "unverified - see PROVENANCE.md",
-   "provenance_status": "unresolved"
+   "source_url": "https://www.navcen.uscg.gov/sites/default/files/images/nr_pics/Arcs/portarc.gif",
+   "source": "USCG Navigation Center, Navigation Rules Arcs of Visibility (https://www.navcen.uscg.gov/navigation-rules-arcs-of-visibility)",
+   "retrieved": "2026-09-05",
+   "rights": "US Government work, public domain (17 U.S.C. 105)",
+   "captions": [
+    "Port SideLight"
+   ],
+   "paragraphs": [
+    "21(b)"
+   ]
   },
   "stbdarc.gif": {
    "file": "stbdarc.gif",
@@ -838,11 +848,16 @@
     225,
     325
    ],
-   "source_url": null,
-   "source": "carried over from mark-brannan/signalk-auto-nav-lights images/; believed USCG, original page not located",
-   "retrieved": "2026-08-29",
-   "rights": "unverified - see PROVENANCE.md",
-   "provenance_status": "unresolved"
+   "source_url": "https://www.navcen.uscg.gov/sites/default/files/images/nr_pics/Arcs/stbdarc.gif",
+   "source": "USCG Navigation Center, Navigation Rules Arcs of Visibility (https://www.navcen.uscg.gov/navigation-rules-arcs-of-visibility)",
+   "retrieved": "2026-09-05",
+   "rights": "US Government work, public domain (17 U.S.C. 105)",
+   "captions": [
+    "Starboard SideLight"
+   ],
+   "paragraphs": [
+    "21(b)"
+   ]
   },
   "sternarc.gif": {
    "file": "sternarc.gif",
@@ -852,11 +867,16 @@
     225,
     325
    ],
-   "source_url": null,
-   "source": "carried over from mark-brannan/signalk-auto-nav-lights images/; believed USCG, original page not located",
-   "retrieved": "2026-08-29",
-   "rights": "unverified - see PROVENANCE.md",
-   "provenance_status": "unresolved"
+   "source_url": "https://www.navcen.uscg.gov/sites/default/files/images/nr_pics/Arcs/sternarc.gif",
+   "source": "USCG Navigation Center, Navigation Rules Arcs of Visibility (https://www.navcen.uscg.gov/navigation-rules-arcs-of-visibility)",
+   "retrieved": "2026-09-05",
+   "rights": "US Government work, public domain (17 U.S.C. 105)",
+   "captions": [
+    "Stern Light"
+   ],
+   "paragraphs": [
+    "21(c)"
+   ]
   },
   "towingarc.gif": {
    "file": "towingarc.gif",
@@ -866,11 +886,17 @@
     225,
     325
    ],
-   "source_url": null,
-   "source": "carried over from mark-brannan/signalk-auto-nav-lights images/; believed USCG, original page not located",
-   "retrieved": "2026-08-29",
-   "rights": "unverified - see PROVENANCE.md",
-   "provenance_status": "unresolved"
+   "source_url": "https://www.navcen.uscg.gov/sites/default/files/images/nr_pics/Arcs/towingarc.gif",
+   "source": "USCG Navigation Center, Navigation Rules Arcs of Visibility (https://www.navcen.uscg.gov/navigation-rules-arcs-of-visibility)",
+   "retrieved": "2026-09-05",
+   "rights": "US Government work, public domain (17 U.S.C. 105)",
+   "captions": [
+    "Towing Light"
+   ],
+   "paragraphs": [
+    "21(d)",
+    "24(a)(iv)"
+   ]
   }
  }
 }

package/data/lights.json

@@ -1,5 +1,5 @@
 {
- "ruleset": "international",
+ "jurisdiction": "intl",
  "bearing_convention": {
   "zero": "right ahead",
   "direction": "clockwise (0 bow, 90 starboard beam, 180 right aft)",
@@ -7,7 +7,7 @@
   "wrap": "an arc with from_deg > to_deg wraps through 0"
  },
  "lights": {
-  "masthead": {
+  "light:masthead": {
    "name": "masthead light",
    "colregs_term": "masthead light",
    "cite": "21(a)",
@@ -21,21 +21,21 @@
    "placement": "over the fore and aft centerline of the vessel; shows from right ahead to 22.5 degrees abaft the beam on either side",
    "rule21": true
   },
-  "sidelights": {
+  "light:sidelights": {
    "name": "sidelights",
    "colregs_term": "sidelights",
    "cite": "21(b)",
    "character": "steady",
    "composite": true,
    "components": [
-    "sidelight_starboard",
-    "sidelight_port"
+    "light:sidelight_starboard",
+    "light:sidelight_port"
    ],
    "placement": "one on each side; in a vessel of less than 20 meters in length they may be combined in one lantern carried on the fore and aft centerline",
    "combined_lantern_max_length_m": 20,
    "rule21": true
   },
-  "sidelight_starboard": {
+  "light:sidelight_starboard": {
    "name": "starboard sidelight",
    "colregs_term": "sidelight",
    "cite": "21(b)",
@@ -49,7 +49,7 @@
    "side": "starboard",
    "rule21": true
   },
-  "sidelight_port": {
+  "light:sidelight_port": {
    "name": "port sidelight",
    "colregs_term": "sidelight",
    "cite": "21(b)",
@@ -63,7 +63,7 @@
    "side": "port",
    "rule21": true
   },
-  "sternlight": {
+  "light:sternlight": {
    "name": "sternlight",
    "colregs_term": "sternlight",
    "cite": "21(c)",
@@ -77,7 +77,7 @@
    "placement": "as nearly as practicable at the stern; shows 67.5 degrees from right aft on each side",
    "rule21": true
   },
-  "towing": {
+  "light:towing": {
    "name": "towing light",
    "colregs_term": "towing light",
    "cite": "21(d)",
@@ -88,10 +88,10 @@
     "from_deg": 112.5,
     "to_deg": 247.5
    },
-   "same_characteristics_as": "sternlight",
+   "same_characteristics_as": "light:sternlight",
    "rule21": true
   },
-  "all_round": {
+  "light:all_round": {
    "name": "all-round light",
    "colregs_term": "all-round light",
    "cite": "21(e)",
@@ -105,7 +105,7 @@
    },
    "rule21": true
   },
-  "flashing": {
+  "light:flashing": {
    "name": "flashing light",
    "colregs_term": "flashing light",
    "cite": "21(f)",
@@ -121,7 +121,7 @@
    "note": "Rule 21(f) defines the character only; every International use of it (23(b), 23(c)) is an all-round light.",
    "rule21": true
   },
-  "torch": {
+  "light:torch": {
    "name": "electric torch or lighted lantern",
    "colregs_term": "electric torch or lighted lantern",
    "cite": "25(d)(i)",
@@ -132,7 +132,7 @@
    "rule21": false,
    "note": "Not a fixed navigation light: it is held ready at hand and shown on approach. It has no prescribed arc, range or position."
   },
-  "deck_lights": {
+  "light:deck_lights": {
    "name": "working or equivalent lights",
    "colregs_term": "working or equivalent lights",
    "cite": "30(c)",
@@ -151,69 +151,69 @@
    {
     "cite": "22(a)",
     "when": {
-     "length_m": {
+     "fact:length_m": {
       "gte": 50
      }
     },
     "ranges_nm": {
-     "masthead": 6,
-     "sidelight": 3,
-     "sternlight": 3,
-     "towing": 3,
-     "all_round": 3
+     "light:masthead": 6,
+     "light:sidelights": 3,
+     "light:sternlight": 3,
+     "light:towing": 3,
+     "light:all_round": 3
     }
    },
    {
     "cite": "22(b)",
     "when": {
-     "length_m": {
+     "fact:length_m": {
       "gte": 12,
       "lt": 50
      }
     },
     "ranges_nm": {
-     "masthead": 5,
-     "sidelight": 2,
-     "sternlight": 2,
-     "towing": 2,
-     "all_round": 2
+     "light:masthead": 5,
+     "light:sidelights": 2,
+     "light:sternlight": 2,
+     "light:towing": 2,
+     "light:all_round": 2
     }
    },
    {
     "cite": "22(b)(i)",
     "when": {
-     "length_m": {
+     "fact:length_m": {
       "gte": 12,
       "lt": 20
      }
     },
     "refines": "22(b)",
     "overrides_nm": {
-     "masthead": 3
+     "light:masthead": 3
     }
    },
    {
     "cite": "22(c)",
     "when": {
-     "length_m": {
+     "fact:length_m": {
       "lt": 12
      }
     },
     "ranges_nm": {
-     "masthead": 2,
-     "sidelight": 1,
-     "sternlight": 2,
-     "towing": 2,
-     "all_round": 2
+     "light:masthead": 2,
+     "light:sidelights": 1,
+     "light:sternlight": 2,
+     "light:towing": 2,
+     "light:all_round": 2
     }
    },
    {
     "cite": "22(d)",
     "when": {
-     "inconspicuous_partly_submerged_tow": true
+     "fact:inconspicuous_partly_submerged_tow": true
     },
     "ranges_nm": {
-     "all_round": 3
+     "light:all_round": 3
     }
    }
   ]