vehicles 0.6.1 → 0.8.0

data/data/plates/_decode/my-index-marks.yml

@@ -0,0 +1,271 @@
+# plates/_decode/my-index-marks.yml — the decodable elements of a Malaysian
+# registration number. DRAFT for verification.
+#
+# ===========================================================================
+# THE SOURCE FINDING, AND IT IS THE GERMAN RESULT RATHER THAN THE IRISH ONE
+# ===========================================================================
+# The Road Transport Act 1987 (Act 333) s. 11(1)(a) requires the Director to
+# assign "THE PRESCRIBED INDEX MARK indicating the registration area in which
+# the vehicle is registered or the status of the owner of the motor vehicle and
+# a separate number". The Act therefore guarantees that this table EXISTS and
+# that it means what it means — area, or owner status — and says nothing about
+# its contents. "Prescribed" points at the Motor Vehicles (Registration and
+# Licensing) Rules 1959, and THAT INSTRUMENT IS NOT ONLINE: the Attorney
+# General's Chambers federal-legislation portal carries 727 subsidiary
+# instruments under Act 333, the oldest from 2000, and the Registration and
+# Licensing Rules appear only as amendments (P.U. (A) 79/2012, 94/2012,
+# 100/2018, 98/2019, 177/2019, 36/2023, 177/2024, 464/2025). No located
+# instrument prescribes an index mark.
+#
+# So every row in section 1 below is sourced to THE AUTHORITY'S OWN LIVE
+# SYSTEM, not to the instrument that legally prescribes it, and carries
+# `evidence: agency-api`. This is precisely the posture plates/_decode/ takes
+# for German district codes, and it is recorded rather than papered over.
+#
+# HOW SECTION 1 WAS OBTAINED — mechanically, from two JPJ endpoints:
+#   * GET  https://portal-api.jpj.gov.my/api/locations
+#       -> the closed list of registration areas and their codes (32 rows,
+#          2026-08-03). This is the list JPJ's own public enquiry form is
+#          built from.
+#   * POST https://portal-api.jpj.gov.my/api/semak-no-pendaftaran-terkini
+#       -> for a given area code, THE REGISTRATION NUMBER CURRENTLY BEING
+#          ISSUED in that area, with the authority's own server timestamp.
+#          Called once per code, 2026-08-03 00:47:43 to 00:49:21 (+08).
+#          28 of 32 returned a reading.
+# The second endpoint is the closest thing Malaysia has to the registry
+# corpora PRD-PLATES §5.2 uses elsewhere: it is the authority stating, on the
+# record and to the minute, what it is issuing. Those readings are the evidence
+# behind BOTH standard series in plates/my.yml and are reproduced per row as
+# `observed_2026_08_03`.
+#
+# ===========================================================================
+# THE DISAGREEMENT BETWEEN JPJ'S OWN TWO PUBLICATIONS — RECORDED, NOT AVERAGED
+# ===========================================================================
+# The JPJ portal page captured 2025-04-13 renders the SAME selector as a plain
+# HTML <select> with THIRTY-SIX options, four of which duplicate a code that is
+# already present with a different office name:
+#     QS = Sibu      AND  QS = Mukah
+#     QB = Sri Aman  AND  QB = Betong
+#     QL = Limbang   AND  QL = Lawas
+#     SS = Sandakan  AND  SM = Sandakan     (two codes, one town)
+# The 2026 JSON API returns THIRTY-TWO rows, keeping only the LATER member of
+# each colliding pair — so Sibu, Sri Aman and Limbang, which are real Sarawak
+# divisions with real plates on the road, have no row in the live list at all.
+# Both captures are recorded below and neither is silently preferred
+# (PRD-PLATES §5.3: record disagreements, never average them). The practical
+# reading is that the JPJ code is a QUERY KEY for a counter, not a bijection
+# with a place, and a decode consumer must treat the mapping as MANY-TO-ONE in
+# both directions.
+#
+# ===========================================================================
+# WHAT THE CODE IS *NOT* — the trap that would make a parse API lie
+# ===========================================================================
+# THE JPJ AREA CODE IS NOT ALWAYS THE PRINTED PREFIX. Three of the live
+# readings prove it outright: querying ST (Tawau) returns SWR 9584; querying SD
+# (Lahad Datu) returns SPA 3076; querying SA (Kota Kinabalu) returns SJT 4199.
+# The printed prefix in East Malaysia is S or Q plus a running letter pair that
+# has drifted well past the two-letter division code. A decoder must therefore
+# read only the FIRST letter as jurisdiction-bearing (S = Sabah, Q = Sarawak,
+# and the single peninsular letters), and must NOT assume the first two letters
+# name a division. In peninsular Malaysia the first letter alone is the mark and
+# the rest is sequence: APK is Perak's A, not a code "AP".
+#
+# Referenced by plates/my.yml from every series' `region_encoding`.
+jurisdiction: my
+topic: index-marks
+authority:
+  name: Jabatan Pengangkutan Jalan Malaysia (JPJ) — Road Transport Department Malaysia
+  url: "https://www.jpj.gov.my/"
+sources:
+  - "https://portal-api.jpj.gov.my/api/locations  # JPJ portal location API — the closed list of 32 registration areas and their codes, as served to the public 'Semakan Nombor Pendaftaran Terkini' form. Queried 2026-08-03"
+  - "https://portal-api.jpj.gov.my/api/semak-no-pendaftaran-terkini  # JPJ 'latest registration number' API — the number currently being issued per area, with the authority's own timestamp. Queried per code 2026-08-03 00:47:43-00:49:21 (+08); 28 of 32 codes returned a reading"
+  - "https://web.archive.org/web/20250413135106/https://www.jpj.gov.my/en/web/main-site/semakan-nombor-pendaftaran-terkini  # the same selector as a 36-option HTML <select>, capturing the four colliding codes the 2026 API drops. Accessed 2026-08-02"
+  - "https://lom.agc.gov.my/ilims/upload/portal/akta/outputaktap/1871744_BI/Act%20333_Final_15%20Oct%202023%20(25.3.24).pdf  # Road Transport Act 1987 s. 11(1)(a) — the statutory existence and meaning of the index mark, and the delegation that makes this table an agency artefact rather than a statutory one. Accessed 2026-08-02"
+  - "https://web.archive.org/web/20140714163606/http://www.kln.gov.my/web/guest/diplomat  # Ministry of Foreign Affairs Malaysia (Wisma Putra), Protocol > Foreign Missions > Diplomat, 'MOTOR VEHICLES' paras 6.4-6.11 — the complete DC, CC and UN allocation tables in sections 2-4 below. Accessed 2026-08-02"
+accessed: "2026-08-03"
+period: { start: 1987 }
+period_evidence: instrument-in-force
+period_note: >-
+  1987 is the Road Transport Act now in force, NOT the date these marks were
+  allotted. The peninsular single letters are conventionally traced to a 1948
+  rationalisation of the pre-war two-letter marks (PK -> A for Perak, JB -> J
+  for Johor and so on) and the Sabah/Sarawak Q and S systems to 1963-1991
+  reorganisations; none of those dates is sourced to an instrument here and
+  none is asserted. Rows added later carry their own `since:` where a date was
+  found; where none was, the row carries no date rather than a guessed one.
+
+# ---------------------------------------------------------------------------
+# 1. REGISTRATION AREAS AND THEIR INDEX MARKS
+#    `code` is JPJ's own key. `printed_prefix_first_letter` is the part a
+#    decoder may rely on. `observed_2026_08_03` is the authority's live counter
+#    at the moment of capture and is EVIDENCE, not a format claim.
+# ---------------------------------------------------------------------------
+areas:
+  peninsular:
+    note: >-
+      Peninsular states and the three federal territories. The INDEX MARK IS
+      THE FIRST LETTER ONLY; the second and third letters are sequence. Note
+      that E, G, H, U, X and Y open no peninsular registration (H is the hire
+      prefix, see plates/my.yml my-taxi), and that I, O and Z are never issued
+      at all.
+    codes:
+      - { code: A, area: Perak, printed_prefix_first_letter: A, observed_2026_08_03: "APK 4191", form: prefix, evidence: agency-api }
+      - { code: B, area: Selangor, printed_prefix_first_letter: B, observed_2026_08_03: "BSS 3435", form: prefix, evidence: agency-api }
+      - { code: C, area: Pahang, printed_prefix_first_letter: C, observed_2026_08_03: "CFH 3542", form: prefix, evidence: agency-api }
+      - { code: D, area: Kelantan, printed_prefix_first_letter: D, observed_2026_08_03: "DFQ 9814", form: prefix, evidence: agency-api }
+      - { code: F, area: "Wilayah Persekutuan Putrajaya", printed_prefix_first_letter: F, observed_2026_08_03: null, form: prefix, evidence: agency-api, note: "listed by the API; the live counter did not return a reading in this pass. Putrajaya's F series is issued in short lettered runs (FA, FB, FC …) rather than continuously, which is consistent with a null reading but does not explain it — recorded as observed, not interpreted." }
+      - { code: J, area: Johor, printed_prefix_first_letter: J, observed_2026_08_03: "JB 6419 J", form: suffix, evidence: agency-api, note: "Johor runs the SUFFIX form: the trailing J is a series letter, not part of the index mark" }
+      - { code: K, area: Kedah, printed_prefix_first_letter: K, observed_2026_08_03: "KGH 3943", form: prefix, evidence: agency-api }
+      - { code: KV, area: Langkawi, printed_prefix: KV, observed_2026_08_03: "KV 859 F", form: suffix, evidence: agency-api, note: "the one peninsular area whose printed prefix is genuinely two letters, and it sits INSIDE Kedah — Langkawi is a duty-free island district with its own mark and its own suffix arrangement" }
+      - { code: L, area: "Wilayah Persekutuan Labuan", printed_prefix_first_letter: L, observed_2026_08_03: "LH 6757", form: prefix, evidence: agency-api, note: "Labuan is geographically off Sabah but registers under a peninsular-style single letter, having been reinstated as a federal territory" }
+      - { code: M, area: Melaka, printed_prefix_first_letter: M, observed_2026_08_03: "MEG 6121", form: prefix, evidence: agency-api }
+      - { code: N, area: "Negeri Sembilan", printed_prefix_first_letter: N, observed_2026_08_03: "NEL 2986", form: prefix, evidence: agency-api }
+      - { code: P, area: "Pulau Pinang", printed_prefix_first_letter: P, observed_2026_08_03: "PSE 4213", form: prefix, evidence: agency-api }
+      - { code: R, area: Perlis, printed_prefix_first_letter: R, observed_2026_08_03: null, form: prefix, evidence: agency-api, note: "present in the API's location list; the counter returned no reading in this pass. Perlis is Malaysia's smallest state by registrations." }
+      - { code: T, area: Terengganu, printed_prefix_first_letter: T, observed_2026_08_03: "TDH 3264", form: prefix, evidence: agency-api }
+      - { code: W, area: "Wilayah Persekutuan Kuala Lumpur", printed_prefix_first_letter: "W or V", observed_2026_08_03: "VRJ 7380", form: prefix, evidence: agency-api, note: "THE MOST VALUABLE SINGLE DATUM IN THIS TABLE. JPJ keys Kuala Lumpur as area code W and its live counter returns a V number. That is the authority's own statement that V IS THE CONTINUATION OF THE W REGISTRATION AREA — one area, two index marks, W exhausted and V in issue. Every secondary account asserts this; this is the primary that carries it. A decoder must map BOTH W and V to Kuala Lumpur." }
+  sabah:
+    note: >-
+      Sabah registrations all begin S. The second letter historically named the
+      division, and the live readings show the running sequence has drifted past
+      it — querying the division code returns a number whose second letter is
+      something else entirely. Read only the leading S as jurisdiction-bearing.
+    codes:
+      - { code: SA, area: "Kota Kinabalu (West Coast)", observed_2026_08_03: "SJT 4199", form: prefix, evidence: agency-api, note: "queried as SA, issuing SJ-series — the drift is explicit here" }
+      - { code: SB, area: Beaufort, observed_2026_08_03: "SB 1644 L", form: suffix, evidence: agency-api }
+      - { code: SD, area: "Lahat Datu", observed_2026_08_03: "SPA 3076", form: prefix, evidence: agency-api, note: "JPJ spells it 'Lahat Datu'; the town is conventionally Lahad Datu. The authority's spelling is kept, per PRD-PLATES §5.3." }
+      - { code: SK, area: Kudat, observed_2026_08_03: "SK 4097 H", form: suffix, evidence: agency-api }
+      - { code: SM, area: Sandakan, observed_2026_08_03: null, form: unknown, evidence: agency-api, note: "one of TWO codes JPJ maps to Sandakan; see the disagreement note in the header" }
+      - { code: SS, area: Sandakan, observed_2026_08_03: "SMW 5063", form: prefix, evidence: agency-api, note: "queried as SS, issuing SM-series" }
+      - { code: ST, area: Tawau, observed_2026_08_03: "SWR 9584", form: prefix, evidence: agency-api, note: "queried as ST, issuing SW-series" }
+      - { code: SU, area: Keningau, observed_2026_08_03: "SU 7665 Q", form: suffix, evidence: agency-api, note: "a Q SUFFIX, which contradicts the secondary claim that Q and S are avoided as East Malaysian suffixes — recorded as counter-evidence in plates/my.yml my-standard-suffix" }
+  sarawak:
+    note: >-
+      Sarawak registrations all begin Q. Same drift and same reading rule as
+      Sabah. Sarawak moved to the Q system in the early 1990s; the date is not
+      sourced here.
+    codes:
+      - { code: QA, area: Kuching, observed_2026_08_03: "QAB 3426 P", form: suffix, evidence: agency-api, note: "three-letter prefix AND a suffix — the fullest Malaysian mark shape in the live sample" }
+      - { code: QB, area: Betong, observed_2026_08_03: "QBH 8695", form: prefix, evidence: agency-api, note: "the 2025 HTML selector maps QB to BOTH Sri Aman and Betong; the 2026 API keeps only Betong" }
+      - { code: QC, area: "Kota Samarahan", observed_2026_08_03: "QCW 4437", form: prefix, evidence: agency-api }
+      - { code: QL, area: Lawas, observed_2026_08_03: "QLG 4546", form: prefix, evidence: agency-api, note: "the 2025 selector maps QL to BOTH Limbang and Lawas; the 2026 API keeps only Lawas" }
+      - { code: QM, area: Miri, observed_2026_08_03: "QM 5771 U", form: suffix, evidence: agency-api }
+      - { code: QP, area: Kapit, observed_2026_08_03: "QPD 9177", form: prefix, evidence: agency-api }
+      - { code: QR, area: Sarikei, observed_2026_08_03: "QRY 2592", form: prefix, evidence: agency-api }
+      - { code: QS, area: Mukah, observed_2026_08_03: "QS 5608 Y", form: suffix, evidence: agency-api, note: "the 2025 selector maps QS to BOTH Sibu and Mukah; the 2026 API keeps only Mukah" }
+      - { code: QT, area: Bintulu, observed_2026_08_03: null, form: unknown, evidence: agency-api }
+  dropped_by_the_live_api:
+    note: >-
+      Present in JPJ's 2025 HTML selector, ABSENT from its 2026 JSON API because
+      each collides with a code the API resolves to another office. They are
+      real Sarawak divisions with plates on the road and are recorded here so
+      that a decoder does not conclude the codes are unallocated.
+    codes:
+      - { code: QS, area: Sibu, evidence: agency-page-2025, collides_with: "QS = Mukah in the 2026 API" }
+      - { code: QB, area: "Sri Aman", evidence: agency-page-2025, collides_with: "QB = Betong in the 2026 API" }
+      - { code: QL, area: Limbang, evidence: agency-page-2025, collides_with: "QL = Lawas in the 2026 API" }
+  never_issued:
+    letters: [I, O, Z]
+    note: >-
+      I and O are never issued anywhere in the system (confusable with 1 and 0);
+      Z is reserved for the Malaysian Armed Forces. Consistent with all 28 live
+      readings and with the absence of any I/O/Z code from JPJ's area list.
+      Sourced to the Malay and English Wikipedia articles — `secondary-wikipedia`
+      — and NOT to any instrument. THERE IS NO MALAYSIAN "NO VOWELS" RULE: A is
+      Perak's mark, and the live sample contains APK, SPA, QAB, SU…U and QM…U.
+
+# ---------------------------------------------------------------------------
+# 2. DIPLOMATIC CORPS ("DC") — allocation by rank.
+#    PRIMARY, from the Ministry of Foreign Affairs, and closed.
+# ---------------------------------------------------------------------------
+diplomatic_dc:
+  authority: "Ministry of Foreign Affairs, Malaysia (Wisma Putra), Protocol Department — 'MOTOR VEHICLES', paras 6.4-6.9"
+  marking: DC
+  colour_rule: >-
+    Para 6.9, verbatim: "All motor vehicles for diplomats and the Chief
+    Representative from the Regional Office of the United Nations will bear
+    white numbers on red field with the markings of 'DC' or 'UN' respectively."
+    / "All motor vehicles for the foreign mission including the consular corps
+    and Offices of the United Nations will bear white numbers on black field
+    with the markings of 'DC', 'CC' or 'UN' respectively." RED = an accredited
+    PERSON. BLACK = an INSTITUTION.
+  retention_rule: >-
+    Para 6.5: "A diplomat serving in Malaysia will be given one 'DC' number
+    according to his ranking. Hence he is required to retain the number plate
+    even when he disposes after 18 months or more as the same number will be
+    given to his new car upon approval from the Ministry of Foreign Affairs."
+  ranks:
+    - { number: "01", holder: "Head of Mission's official car" }
+    - { number: "02, 03", holder: "Head of Mission's personal car" }
+    - { number: "04", holder: "Deputy Chief of Mission / Deputy High Commissioner / Minister" }
+    - { number: "05", holder: "Minister Counsellor" }
+    - { number: "06-09", holder: "Counsellor" }
+    - { number: "10-19", holder: "First Secretary" }
+    - { number: "20-29", holder: "Second Secretary" }
+    - { number: "30-39", holder: "Third Secretary" }
+    - { number: "40-59", holder: "Attaché, including Military Advisers, Trade Representatives, Defence Advisers and other similar ranks" }
+    - { number: "60-99", holder: "the SECOND duty-free car of a diplomat entitled to two (para 6.6)" }
+    - { number: "101 and above", holder: "vehicles registered in the name of the foreign mission (para 6.8)" }
+  chargé_note: "Para 6.7: 'Personal cars of Charge d' Affaires will be numbered according to their respective ranks.'"
+  gap: >-
+    THE COUNTRY-CODE TABLE IS NOT ON THIS PAGE and was not located anywhere.
+    The number group above is the RANK group; the sending state's code is a
+    separate printed group whose allocation is unsourced. PRD-PLATES puts
+    diplomatic decode tables at L4 and this one is deliberately left there
+    rather than guessed.
+
+# ---------------------------------------------------------------------------
+# 3. CONSULAR CORPS ("CC") — allocation by CONSULAR DISTRICT, which makes this
+#    a genuine geographic decode dimension. PRIMARY and closed.
+# ---------------------------------------------------------------------------
+consular_cc:
+  authority: "Wisma Putra, 'MOTOR VEHICLES', para 6.10"
+  marking: CC
+  colour: "white numbers on black field (para 6.9)"
+  columns: ["head of consular mission", "heads of consular offices", "vehicles registered in the name of the consular mission"]
+  districts:
+    - { district: "Kuala Lumpur", head_of_mission: "01", office_heads: "10-19", mission_registered: "100-199" }
+    - { district: "Penang", head_of_mission: "02", office_heads: "20-29", mission_registered: "200-299" }
+    - { district: "Kota Bharu", head_of_mission: "03", office_heads: "30-39", mission_registered: "300-399" }
+    - { district: "Kota Kinabalu", head_of_mission: "04", office_heads: "40-49", mission_registered: "400-499" }
+    - { district: "Kuching", head_of_mission: "05", office_heads: "50-59", mission_registered: "500-599" }
+    - { district: "for other missions established hereafter", head_of_mission: "06, 07, 08, 09", office_heads: "60-69, 70-79, 80-89, 90-99", mission_registered: "600-699, 700-799, 800-899, 900-999" }
+  honorary_consuls: >-
+    Same page, verbatim: "Honorary Consuls are only issued with ID cards." There
+    is NO Malaysian honorary-consul plate — a clean negative fact, and the exact
+    opposite of Thailand, which gives honorary consuls their own grey plate.
+  decode_rule: >-
+    The LEADING DIGIT of a Malaysian CC number is the consular district
+    (1 = Kuala Lumpur, 2 = Penang, 3 = Kota Bharu, 4 = Kota Kinabalu,
+    5 = Kuching) and its MAGNITUDE is the holder class (one digit = head of
+    mission, two digits = head of a consular office, three digits = the mission
+    itself). That is a real, primary-sourced, two-dimensional decode.
+
+# ---------------------------------------------------------------------------
+# 4. UNITED NATIONS ("UN"). PRIMARY and closed as far as the page goes.
+# ---------------------------------------------------------------------------
+united_nations:
+  authority: "Wisma Putra, 'MOTOR VEHICLES', para 6.11"
+  marking: UN
+  allocation:
+    - { number: "01", holder: "official car of the Head of a United Nations Office or Specialised Agency" }
+    - { number: "02-05", holder: "personal car (if any) of that Head" }
+    - { number: "06-99", holder: "cars registered in the name of other UN officials" }
+    - { number: "101 and above", holder: "cars registered in the name of the UN Office or Specialised Agency" }
+  agency_numbers:
+    - { agency: UNDP, printed: "10 UN" }
+    - { agency: WHO, printed: "11 UN" }
+    - { agency: FAO, printed: "12 UN" }
+    - { agency: UNHCR, printed: "14 UN" }
+  agency_note: >-
+    Four agencies, and 13 IS SKIPPED. The page gives no reason and none is
+    invented here. The printed forms above are reproduced exactly as the
+    ministry writes them, which is why plates/my.yml my-un carries a
+    `recall-only` regex accepting both a one-group and a two-group arrangement:
+    "10 UN" and the two-group diplomatic-style form cannot both be described by
+    one strict grammar on this evidence.
+  colour: >-
+    RED field for the Chief Representative of the UN Regional Office; BLACK
+    field for UN Offices (para 6.9). JPJ's own specification page independently
+    lists "the UN" among those entitled to the red plate, alongside embassies
+    and the International Natural Rubber Association.

data/data/plates/_decode/no-counties-1913.yml

@@ -0,0 +1,148 @@
+# plates/_decode/no-counties-1913.yml — the Norwegian SINGLE-letter county
+# index, 1 April 1913 to 31 March 1971.
+#
+# PROVENANCE, STATED FIRST BECAUSE IT IS NOT UNIFORM. Two different things
+# live in this file and they are sourced differently:
+#
+#   * THE ERA'S BOUNDARIES ARE STATUTORY. Forskrift om bruk av kjøretøy
+#     (FOR-1990-01-25-92) § 2-16 is headed "Kjennemerke for registreringsordning
+#     før 1. april 1971" and gives the composition — "En bokstav og tre til
+#     seks tall" — in a regulation that is IN FORCE TODAY, because a 30-year-old
+#     vehicle may still be plated to the order of its first registration
+#     (§ 2-15). So the format and the closing date are primary.
+#   * THE LETTER-TO-COUNTY MAPPING IS NOT. No Norwegian instrument reachable in
+#     this pass enumerates it. The allocation was made by kongelig resolusjon
+#     of 18 March 1913 and amended by later royal resolutions, none of which is
+#     carried by lovdata (whose holdings begin far later) and none of which was
+#     retrieved. Every row below is therefore `secondary-wikipedia`, taken from
+#     no.wikipedia's article and re-expressed in this dataset's own shape and
+#     ordering — keyed by LETTER, which is the decode direction, rather than by
+#     the article's police-district arrangement.
+#
+# WHAT WAS DELIBERATELY NOT TAKEN. The source article also carries per-police-
+# district NUMBER-RANGE allocations sourced to a 1936 almanac ("Hvem Hvad Hvor"
+# 1936). Those are a single-year snapshot of an allocation that moved
+# constantly, and shipping them would assert a period discipline the evidence
+# cannot carry. They are omitted on purpose, not overlooked.
+#
+# THE ROWS ARE PERIODISED, because four of them genuinely move: G dies, Z is
+# born, Q and P arrive late. Those four dates are the reason this table is
+# worth having — a Norwegian plate reading "G-1234" cannot postdate 1930, and
+# one reading "P-123" cannot predate 1967.
+jurisdiction: "no"
+topic: counties
+authority:
+  name: Statens vegvesen (successor); the allocation was made by kongelig resolusjon
+  url: "https://lovdata.no/dokument/SF/forskrift/1990-01-25-92/KAPITTEL_2"
+period: { start: 1913, end: 1971 }
+period_evidence: statutory-date-end-secondary-start
+period_note: >-
+  Both boundaries are dated to the day, from different tiers. START: the lov om
+  motorvogner of 21 June 1912 and the kongelig resolusjon of 18 March 1913 both
+  took effect on 1 APRIL 1913 (secondary-wikipedia — neither instrument was
+  retrieved). END: 31 MARCH 1971, which is primary — FOR-1990-01-25-92 § 2-16
+  names the order "før 1. april 1971" and § 2-17 opens the successor order "fra
+  og med 1. april 1971", so the boundary is stated in an in-force regulation
+  even though the 1913 instrument is not.
+sources:
+  - "https://lovdata.no/dokument/SF/forskrift/1990-01-25-92/KAPITTEL_2  # FOR-1990-01-25-92 § 2-16: 'En bokstav og tre til seks tall', with a horizontal stroke at half height between letter and digits; § 2-15: the 30-year eligibility that keeps this order live. PRIMARY. Accessed 2026-08-02"
+  - "https://no.wikipedia.org/wiki/Kjennemerke_for_motorkj%C3%B8ret%C3%B8y_i_Norge  # secondary-wikipedia (rev. 2026-07-16): EVERY letter-to-county row below; the 1912 lov / 1913 kgl.res. commencement of 1 April 1913; the Z (kgl.res. 20 April 1929), G (invalid 1 January 1931), Q (kgl.res. 12 July 1934 § 63) and P (1967) datings; the 1918 amt->fylke renaming; the June 1991 revival. Accessed 2026-08-02"
+
+# ---------------------------------------------------------------------------
+# THE LETTER INDEX. `amt` is the pre-1918 name of the unit, `fylke` the name it
+# carried after the 1918 renaming took effect (1 January 1919) — the SAME
+# territory under two names, not two allocations, which is why one row carries
+# both. `period` is per row and closes at 1971 unless the letter died earlier.
+# ---------------------------------------------------------------------------
+letters:
+  A: { amt: "Kristiania amt", fylke: "Oslo", period: { start: 1913, end: 1971 } }
+  B: { amt: "Smaalenenes amt", fylke: "Østfold", period: { start: 1913, end: 1971 } }
+  C: { amt: "Akershus amt", fylke: "Akershus", period: { start: 1913, end: 1971 } }
+  D: { amt: "Hedemarkens amt", fylke: "Hedmark", period: { start: 1913, end: 1971 } }
+  E: { amt: "Kristians amt", fylke: "Oppland", period: { start: 1913, end: 1971 } }
+  F: { amt: "Buskeruds amt", fylke: "Buskerud", period: { start: 1913, end: 1971 } }
+  G:
+    amt: "Jarlsberg og Larviks amt"
+    fylke: "Vestfold"
+    period: { start: 1913, end: 1931 }
+    note: >-
+      WITHDRAWN, and the only letter in this table that was. G was invalid from
+      1 JANUARY 1931 because C and G proved too easy to confuse in traffic;
+      Vestfold had already begun issuing Z from 20 April 1929, and every G plate
+      was exchanged for a Z plate KEEPING THE SAME DIGITS over the winter of
+      1930/31. A "G-" plate is therefore a hard pre-1931 artefact, and its Z
+      twin carries the identical number.
+  H: { amt: "Bratsberg amt", fylke: "Telemark", period: { start: 1913, end: 1971 } }
+  I: { amt: "Nedenes amt", fylke: "Aust-Agder", period: { start: 1913, end: 1971 } }
+  K: { amt: "Lister og Mandals amt", fylke: "Vest-Agder", period: { start: 1913, end: 1971 } }
+  L: { amt: "Stavanger amt", fylke: "Rogaland", period: { start: 1913, end: 1971 } }
+  O:
+    amt: "Bergen amt"
+    fylke: "Bergen"
+    period: { start: 1913, end: 1971 }
+    note: >-
+      A CITY, not a county — Bergen was its own registration unit alongside
+      Hordaland (R). The royal household still holds O-1 for use in Bergen.
+  P:
+    fylke: "Svalbard"
+    period: { start: 1967, end: 1971 }
+    note: >-
+      SVALBARD, allocated only in 1967 — half a century after the rest of the
+      table. Svalbard's road network was privately owned by Store Norske
+      Spitsbergen Kulkompani, so P plates were YELLOW ON BLACK (the
+      not-approved-for-public-road colouring) and were not valid on the
+      mainland. P is one of the two letters NOT revived for veteran use in 1991.
+  Q:
+    fylke: "Ufortollete biler (uncustomed vehicles)"
+    period: { start: 1934, end: 1971 }
+    note: >-
+      NOT GEOGRAPHIC AT ALL — a nationwide series for the temporary registration
+      of vehicles on which customs duty had not been paid, introduced by
+      kongelig resolusjon of 12 July 1934 § 63. It is the direct ancestor of the
+      modern red-bordered export plate (`no-export-1971`), which replaced it in
+      1971. Q is the other letter not revived in 1991. A parse API must not
+      treat Q as a place.
+  R: { amt: "Søndre Bergenhus amt", fylke: "Hordaland", period: { start: 1913, end: 1971 } }
+  S: { amt: "Nordre Bergenhus amt", fylke: "Sogn og Fjordane", period: { start: 1913, end: 1971 } }
+  T: { amt: "Romsdals amt", fylke: "Møre og Romsdal", period: { start: 1913, end: 1971 } }
+  U: { amt: "Søndre Trondhjems amt", fylke: "Sør-Trøndelag", period: { start: 1913, end: 1971 } }
+  V: { amt: "Nordre Trondhjems amt", fylke: "Nord-Trøndelag", period: { start: 1913, end: 1971 } }
+  W: { amt: "Nordlands amt", fylke: "Nordland", period: { start: 1913, end: 1971 } }
+  X: { amt: "Tromsø amt", fylke: "Troms", period: { start: 1913, end: 1971 } }
+  Y: { amt: "Finmarken amt", fylke: "Finnmark", period: { start: 1913, end: 1971 } }
+  Z:
+    fylke: "Vestfold"
+    period: { start: 1929, end: 1971 }
+    note: "Vestfold from 20 April 1929, replacing G — see the G row."
+
+letters_never_used: [J, M, N]
+letters_never_used_note: >-
+  J, M and N appear nowhere in the allocation, and Æ, Ø and Å cannot be written
+  in this dataset's serial alphabet at all. Recorded as an observation about the
+  table, not as a sourced rule: no instrument stating a letter-exclusion policy
+  for the 1913 order was retrieved.
+
+revival:
+  from: 1991
+  scope: >-
+    County letters came back into LIMITED use from June 1991: a vehicle
+    previously registered on a county-letter plate, or an imported vehicle of
+    model year 1970 or older, may be registered on one at the owner's choice,
+    with three to six digits in any combination — including the "telefonnummer"
+    grouping 00-00-00. Every previously used letter is available EXCEPT P and Q.
+    Unlike the 1913-1971 originals these plates follow the vehicle on sale.
+  authority_basis: >-
+    The current statutory hook is FOR-1990-01-25-92 §§ 2-15 to 2-18 (a vehicle
+    first registered more than 30 years ago may be plated to the order in force
+    at its first registration). The June 1991 start date and the P/Q exclusion
+    are secondary-wikipedia; no instrument dating the revival was retrieved.
+  source: "https://no.wikipedia.org/wiki/Kjennemerke_for_motorkj%C3%B8ret%C3%B8y_i_Norge  # secondary-wikipedia (rev. 2026-07-16). Accessed 2026-08-02"
+
+royal_household:
+  reserved: "A-1 to A-20, and O-1 (used only in Bergen)"
+  note: >-
+    The one part of this table that never lapsed: the royal household kept the
+    A-1..A-20 series through the 1971 cutover and still receives new
+    registrations on it. Ordinary plates are used when the vehicle is driven
+    without a member of the household aboard, and on sale.
+  source: "https://no.wikipedia.org/wiki/Kjennemerke_for_motorkj%C3%B8ret%C3%B8y_i_Norge  # secondary-wikipedia (rev. 2026-07-16). Accessed 2026-08-02"