vehicles 0.4.1 → 0.8.0

data/data/plates/_decode/mx-entity-series.yml

@@ -0,0 +1,380 @@
+# plates/_decode/mx-entity-series.yml — Mexico's ENTIDAD FEDERATIVA serial
+# ranges: the table that turns a Mexican private plate into a state.
+#
+# WHAT THIS IS, AND WHY IT IS NOT A PREFIX TABLE. Mexico does not encode its
+# states the way Germany encodes its districts. There is no district letter and
+# no province suffix: the 32 entidades federativas issue out of ONE national
+# serial space, and the state is recoverable only by asking WHICH RANGE the
+# serial falls in. Those ranges are enacted, closed and primary — Apéndice "C"
+# Normativo of NOM-001-SCT-2-2016 ("ESTABLECE LA ASIGNACIÓN DE SERIES POR
+# ENTIDAD FEDERATIVA, LA CIUDAD DE MÉXICO Y LA SECRETARÍA, POR TIPO DE SERVICIO
+# Y VEHÍCULO, MATRICULADOS EN LA REPÚBLICA MEXICANA"), read off the Diario
+# Oficial de la Federación text of 24 June 2016. Every row below is that
+# appendix.
+#
+# THE DECODE IS A RANGE COMPARISON, NOT A LOOKUP. `AAA-001-A` to `AFZ-999-Z`
+# is Aguascalientes; `AGA-001-A` to `CYZ-999-Z` is Baja California. A consumer
+# decodes by comparing the LETTER GROUP against the interval endpoints in the
+# NOM's own collating order — and that order is NOT plain A-Z, because the same
+# appendix forbids four letters outright:
+#
+#   "NOTA: EN LOS CARACTERES ALFABÉTICOS NO DEBERÁN UTILIZARSE LAS LETRAS
+#    I, Ñ, O, Q."
+#
+# so the alphabet actually walked is A B C D E F G H J K L M N P R S T U V W X
+# Y Z (23 letters). `alphabet:` below is that sequence, machine-readable, and a
+# decoder that compares with a 26-letter alphabet will mis-assign every range
+# that straddles a forbidden letter.
+#
+# FOUR CAUTIONS, all of them load-bearing:
+#
+# 1. RANGES ARE ALLOCATIONS, NOT OCCUPANCY. The NOM allocates Baja California
+#    32,765,202 private-car combinations. Nobody has issued them. A range hit
+#    says "if this plate exists, it was issued by that state", never "this
+#    plate exists".
+# 2. THE RANGES ARE PER SERVICE TYPE AND PER VEHICLE TYPE. The private-car
+#    table and the private-truck table are different serial spaces in different
+#    formats (AAA-000-A vs AA-0000-A); the border (fronterizo) tables are a
+#    third; the public-local tables a fourth. They are kept apart here for the
+#    same reason plates/_decode/it-provinces.yml keeps its two tables apart.
+# 3. THE 2016 ALLOCATION REPLACED THE 2000 ONE. The Acuerdo of 25 September
+#    2000 (DOF) carried its own per-entity assignment for the AAA-00-00 era;
+#    those ranges are NOT these ranges, and this file does not carry them.
+#    A pre-2016 Mexican plate does not decode through this table.
+# 4. CIUDAD DE MÉXICO IS NOT IN THE STATE TABLE. It gets its own format
+#    (A00-AAA for private cars) and its own single range, listed separately
+#    below — which is why a CDMX plate can never collide with a state plate.
+jurisdiction: mx
+topic: entity-series
+authority:
+  name: "Secretaría de Comunicaciones y Transportes — NOM-001-SCT-2-2016, Apéndice C Normativo"
+  url: "https://www.dof.gob.mx/nota_detalle.php?codigo=5442476&fecha=24/06/2016"
+sources:
+  - "https://www.dof.gob.mx/nota_detalle.php?codigo=5442476&fecha=24/06/2016  # NOM-001-SCT-2-2016, Apéndice C Normativo — every range row below, verbatim, plus the note excluding I, Ñ, O and Q; accessed 2026-08-02"
+  - "https://www.dof.gob.mx/nota_detalle.php?codigo=5442476&fecha=24/06/2016  # Apéndice B Normativo, Tabla C — the character ORDER each range is expressed in (AAA-000-A private car, AA-0000-A private truck, A-000-AAA public-local car, A00-AAA-0 border private car)"
+period: { start: 2016 }
+period_evidence: enabling-instrument
+period_note: >-
+  The allocation below is created by NOM-001-SCT-2-2016 itself, published in the
+  DOF on 24 June 2016 and in force sixty calendar days later (numeral 13:
+  "la presente Norma Oficial Mexicana entrará en vigor sesenta días naturales
+  contados a partir de la fecha de su publicación en el Diario Oficial de la
+  Federación") — 23 August 2016. The NOM's own recital says WHY it was needed:
+  the series assigned by the 2000 Acuerdo "se han agotado para algunos tipos de
+  servicio en diversas Entidades Federativas, la Ciudad de México y el
+  Autotransporte Federal, se hace necesario realizar una nueva asignación y
+  distribución de series, que evite la duplicidad de las mismas".
+
+alphabet:
+  order: [A, B, C, D, E, F, G, H, J, K, L, M, N, P, R, S, T, U, V, W, X, Y, Z]
+  excluded: [I, "Ñ", O, Q]
+  source: "https://www.dof.gob.mx/nota_detalle.php?codigo=5442476&fecha=24/06/2016  # 'NOTA: EN LOS CARACTERES ALFABÉTICOS NO DEBERÁN UTILIZARSE LAS LETRAS I, Ñ, O, Q.' — repeated under every per-entity table in Apéndice C"
+  note: >-
+    Ñ is excluded by the NOM but is not in this dataset's serial alphabet
+    (plates/_meta/separators.yml) in the first place, so it never reaches a
+    regex; it is recorded because the NOM records it.
+
+# ---------------------------------------------------------------------------
+# 1. TRANSPORTE PRIVADO, ENTIDADES FEDERATIVAS (non-border). Referenced by
+#    series mx-private-car-2016 (AAA-000-A) and mx-private-truck-2016
+#    (AA-0000-A).
+# ---------------------------------------------------------------------------
+private_entity:
+  - { code: MX-AGU, name: "Aguascalientes", car_from: "AAA-001-A", car_to: "AFZ-999-Z", car_allocated: 3170826, truck_from: "AA-0001-A", truck_to: "AF-9999-Z", truck_allocated: 1379862 }
+  - { code: MX-BCN, name: "Baja California", car_from: "AGA-001-A", car_to: "CYZ-999-Z", car_allocated: 32765202, truck_from: "AG-0001-A", truck_to: "CD-9999-Z", truck_allocated: 10118988 }
+  - { code: MX-BCS, name: "Baja California Sur", car_from: "CZA-001-A", car_to: "DEZ-999-Z", car_allocated: 3170826, truck_from: "CE-0001-A", truck_to: "CL-9999-Z", truck_allocated: 1609839 }
+  - { code: MX-CAM, name: "Campeche", car_from: "DFA-001-A", car_to: "DKZ-999-Z", car_allocated: 2642355, truck_from: "CM-0001-A", truck_to: "CU-9999-Z", truck_allocated: 1609839 }
+  - { code: MX-CHP, name: "Chiapas", car_from: "DLA-001-A", car_to: "DSZ-999-Z", car_allocated: 3170826, truck_from: "CV-0001-A", truck_to: "DC-9999-Z", truck_allocated: 1839816 }
+  - { code: MX-CHH, name: "Chihuahua", car_from: "DTA-001-A", car_to: "ETZ-999-Z", car_allocated: 12683304, truck_from: "DD-0001-A", truck_to: "EG-9999-Z", truck_allocated: 6209379 }
+  - { code: MX-COA, name: "Coahuila de Zaragoza", car_from: "EUA-001-A", car_to: "FPZ-999-Z", car_allocated: 10569420, truck_from: "EH-0001-A", truck_to: "FB-9999-Z", truck_allocated: 4139586 }
+  - { code: MX-COL, name: "Colima", car_from: "FRA-001-A", car_to: "FWZ-999-Z", car_allocated: 3170826, truck_from: "FC-0001-A", truck_to: "FJ-9999-Z", truck_allocated: 1609839 }
+  - { code: MX-DUR, name: "Durango", car_from: "FXA-001-A", car_to: "GFZ-999-Z", car_allocated: 4756239, truck_from: "FK-0001-A", truck_to: "FZ-9999-Z", truck_allocated: 3219678 }
+  - { code: MX-MEX, name: "México (Estado de)", car_from: "LGA-001-A", car_to: "PEZ-999-Z", car_allocated: 35936028, truck_from: "KL-0001-A", truck_to: "MS-9999-Z", truck_allocated: 11958804 }
+  - { code: MX-GUA, name: "Guanajuato", car_from: "GGA-001-A", car_to: "GYZ-999-Z", car_allocated: 8455536, truck_from: "FY-0001-A", truck_to: "GW-9999-Z", truck_allocated: 5059540 }
+  - { code: MX-GRO, name: "Guerrero", car_from: "GZA-001-A", car_to: "HFZ-999-Z", car_allocated: 3699297, truck_from: "GX-0001-A", truck_to: "HG-9999-Z", truck_allocated: 2299770 }
+  - { code: MX-HID, name: "Hidalgo", car_from: "HGA-001-A", car_to: "HRZ-999-Z", car_allocated: 4756239, truck_from: "HH-0001-A", truck_to: "HT-9999-Z", truck_allocated: 2299770 }
+  - { code: MX-JAL, name: "Jalisco", car_from: "HSA-001-A", car_to: "LFZ-999-Z", car_allocated: 31708260, truck_from: "HU-0001-A", truck_to: "KK-9999-Z", truck_allocated: 8969103 }
+  - { code: MX-MIC, name: "Michoacán de Ocampo", car_from: "PFA-001-A", car_to: "PUZ-999-Z", car_allocated: 6870123, truck_from: "MT-0001-A", truck_to: "NT-9999-Z", truck_allocated: 5519448 }
+  - { code: MX-MOR, name: "Morelos", car_from: "PVA-001-A", car_to: "RDZ-999-Z", car_allocated: 4756239, truck_from: "UN-0001-A", truck_to: "NZ-9999-Z", truck_allocated: 1379862 }
+  - { code: MX-NAY, name: "Nayarit", car_from: "REA-001-A", car_to: "RJZ-999-Z", car_allocated: 2642355, truck_from: "PA-0001-A", truck_to: "PG-9999-Z", truck_allocated: 1609839 }
+  - { code: MX-NLE, name: "Nuevo León", car_from: "RKA-001-A", car_to: "TGZ-999-Z", car_allocated: 23252724, truck_from: "PH-0001-A", truck_to: "RP-9999-Z", truck_allocated: 6899310 }
+  - { code: MX-OAX, name: "Oaxaca", car_from: "THA-001-A", car_to: "TMZ-999-Z", car_allocated: 2642355, truck_from: "RR-0001-A", truck_to: "RY-9999-Z", truck_allocated: 3679632 }
+  - { code: MX-PUE, name: "Puebla", car_from: "TNA-001-A", car_to: "UJZ-999-Z", car_allocated: 10569420, truck_from: "RZ-0001-A", truck_to: "SR-9999-Z", truck_allocated: 3679632 }
+  - { code: MX-QUE, name: "Querétaro", car_from: "UKA-001-A", car_to: "UPZ-999-Z", car_allocated: 2642355, truck_from: "SS-0001-A", truck_to: "SY-9999-Z", truck_allocated: 1609839 }
+  - { code: MX-ROO, name: "Quintana Roo", car_from: "URA-001-A", car_to: "UVZ-999-Z", car_allocated: 2642355, truck_from: "SZ-0001-A", truck_to: "TB-9999-Z", truck_allocated: 689931 }
+  - { code: MX-SLP, name: "San Luis Potosí", car_from: "UWA-001-A", car_to: "VEZ-999-Z", car_allocated: 4756239, truck_from: "TC-0001-A", truck_to: "TP-9999-Z", truck_allocated: 2759724 }
+  - { code: MX-SIN, name: "Sinaloa", car_from: "VFA-001-A", car_to: "VSZ-999-Z", car_allocated: 5813181, truck_from: "TR-0001-A", truck_to: "UL-9999-Z", truck_allocated: 4599540 }
+  - { code: MX-SON, name: "Sonora", car_from: "VTA-001-A", car_to: "WKZ-999-Z", car_allocated: 8984007, truck_from: "UM-0001-A", truck_to: "VK-9999-Z", truck_allocated: 5059494 }
+  - { code: MX-TAB, name: "Tabasco", car_from: "WLA-001-A", car_to: "WWZ-999-Z", car_allocated: 5284710, truck_from: "VL-0001-A", truck_to: "VT-9999-Z", truck_allocated: 1609839 }
+  - { code: MX-TAM, name: "Tamaulipas", car_from: "WXA-001-A", car_to: "XSZ-999-Z", car_allocated: 10040949, truck_from: "VU-0001-A", truck_to: "WX-9999-Z", truck_allocated: 6209379 }
+  - { code: MX-TLA, name: "Tlaxcala", car_from: "XTA-001-A", car_to: "XXZ-999-Z", car_allocated: 2642355, truck_from: "WY-0001-A", truck_to: "XE-9999-Z", truck_allocated: 1609839 }
+  - { code: MX-VER, name: "Veracruz de Ignacio de la Llave", car_from: "XYA-001-A", car_to: "YVZ-999-Z", car_allocated: 11097891, truck_from: "XF-0001-A", truck_to: "YM-9999-Z", truck_allocated: 6899310 }
+  - { code: MX-YUC, name: "Yucatán", car_from: "YWA-001-A", car_to: "ZCZ-999-Z", car_allocated: 3699297, truck_from: "YN-0001-A", truck_to: "YU-9999-Z", truck_allocated: 1379862 }
+  - { code: MX-ZAC, name: "Zacatecas", car_from: "ZDA-001-A", car_to: "ZHZ-999-Z", car_allocated: 2642355, truck_from: "YV-0001-A", truck_to: "ZJ-9999-Z", truck_allocated: 3219678 }
+
+# ---------------------------------------------------------------------------
+# 2. CIUDAD DE MÉXICO. Its own formats, its own single ranges — no overlap with
+#    the state table above is possible because the FORMATS differ.
+# ---------------------------------------------------------------------------
+private_cdmx:
+  - { code: MX-CMX, name: "Ciudad de México", vehicle: car,   format: "A00-AAA",   from: "A01-AAA", to: "Z99-ZZZ", allocated: 27704259 }
+  - { code: MX-CMX, name: "Ciudad de México", vehicle: truck, format: "A-000-AA",  from: "A-001-AA", to: "Z-999-ZZ", allocated: 12154833 }
+  - { code: MX-CMX, name: "Ciudad de México", vehicle: bus,   format: "00-AA-0",   from: "01-AA-1",  to: "99-ZZ-9",  allocated: 471339 }
+  - { code: MX-CMX, name: "Ciudad de México", vehicle: trailer, format: "A-0A-00", from: "A-1A-01",  to: "Z-9Z-99",  allocated: 471339 }
+
+# ---------------------------------------------------------------------------
+# 3. TRANSPORTE PRIVADO FRONTERIZO — the BORDER-ZONE private series, a
+#    separate format (A00-AAA-0 for cars) issued only by the seven entities
+#    the NOM lists. Referenced by series mx-private-border-car-2016.
+# ---------------------------------------------------------------------------
+private_border:
+  - { code: MX-BCN, name: "Baja California", car_from: "A01-NRA-1", car_to: "Z99-NZZ-9", car_allocated: 4242051, truck_from: "ZJA-001-A", truck_to: "ZLC-999-Z", truck_allocated: 1125873, bus_from: "ZLD-001-A", bus_to: "ZLN-999-Z", trailer_from: "ZLP-001-A", trailer_to: "ZLZ-999-Z" }
+  - { code: MX-BCS, name: "Baja California Sur", car_from: "A01-PLA-1", car_to: "Z99-PRZ-9", car_allocated: 2356695, truck_from: "ZMA-001-A", truck_to: "ZNC-999-Z", truck_allocated: 597402, bus_from: "ZND-001-A", bus_to: "ZNN-999-Z", trailer_from: "ZNP-001-A", trailer_to: "ZNZ-999-Z" }
+  - { code: MX-COA, name: "Coahuila de Zaragoza", car_from: "A01-RAA-1", car_to: "Z99-REZ-9", car_allocated: 2356695, truck_from: "ZPA-001-A", truck_to: "ZRC-999-Z", truck_allocated: 597402, bus_from: "ZRD-001-A", bus_to: "ZRN-999-Z", trailer_from: "ZRP-001-A", trailer_to: "ZRZ-999-Z" }
+  - { code: MX-CHP, name: "Chiapas", car_from: "A01-RPA-1", car_to: "Z99-RTZ-9", car_allocated: 1885356, truck_from: "ZSA-001-A", truck_to: "ZST-999-Z", truck_allocated: 390609, bus_from: "ZSU-001-A", bus_to: "ZTD-999-Z", trailer_from: "ZTE-001-A", trailer_to: "ZTP-999-Z" }
+  - { code: MX-CHH, name: "Chihuahua", car_from: "A01-SAA-1", car_to: "Z99-SKZ-9", car_allocated: 4713390, truck_from: "ZTR-001-A", truck_to: "ZUY-999-Z", truck_allocated: 712287, bus_from: "ZUZ-001-A", bus_to: "ZVJ-999-Z", trailer_from: "ZVK-001-A", trailer_to: "ZVV-999-Z" }
+  - { code: MX-SON, name: "Sonora", car_from: "A01-SWA-1", car_to: "Z99-TAZ-9", car_allocated: 2356695, truck_from: "ZVW-001-A", truck_to: "ZXB-999-Z", truck_allocated: 666333, bus_from: "ZXC-001-A", bus_to: "ZXM-999-Z", trailer_from: "ZXN-001-A", trailer_to: "ZXY-999-Z" }
+  - { code: MX-TAM, name: "Tamaulipas", car_from: "A01-THA-1", car_to: "Z99-TTZ-9", car_allocated: 4713390, truck_from: "ZXZ-001-A", truck_to: "ZZC-999-Z", truck_allocated: 620379, bus_from: "ZZD-001-A", bus_to: "ZZN-999-Z", trailer_from: "ZZP-001-A", trailer_to: "ZZZ-999-Z" }
+
+# ---------------------------------------------------------------------------
+# 4. PÚBLICO LOCAL FRONTERIZO — the border public-transport series
+#    (A-000-AAA). Kept separate: same shape as the ordinary public-local
+#    car format, different range block (all in the Z-tail).
+# ---------------------------------------------------------------------------
+public_border:
+  - { code: MX-BCN, car_from: "A-001-ZLA", car_to: "Z-999-ZMN", car_allocated: 827172, truck_from: "A-001-ZMP", truck_to: "Z-999-ZNB", truck_allocated: 275724 }
+  - { code: MX-BCS, car_from: "A-001-ZNR", car_to: "Z-999-ZPJ", car_allocated: 413586, truck_from: "A-001-ZPK", truck_to: "Z-999-ZPR", truck_allocated: 137862 }
+  - { code: MX-COA, car_from: "A-001-ZPY", car_to: "Z-999-ZRS", car_allocated: 413586, truck_from: "A-001-ZRT", truck_to: "Z-999-ZRY", truck_allocated: 137862 }
+  - { code: MX-CHP, car_from: "A-001-ZSF", car_to: "Z-999-ZSZ", car_allocated: 413586, truck_from: "A-001-ZTA", truck_to: "Z-999-ZTF", truck_allocated: 137862 }
+  - { code: MX-CHH, car_from: "A-001-ZTN", car_to: "Z-999-ZVA", car_allocated: 804195, truck_from: "A-001-ZVB", truck_to: "Z-999-ZVN", truck_allocated: 275724 }
+  - { code: MX-SON, car_from: "A-001-ZWC", car_to: "Z-999-ZWW", car_allocated: 413586, truck_from: "A-001-ZWX", truck_to: "Z-999-ZXC", truck_allocated: 137862 }
+  - { code: MX-TAM, car_from: "A-001-ZXK", car_to: "Z-999-ZYY", car_allocated: 827172, truck_from: "A-001-ZYZ", truck_to: "Z-999-ZZL", truck_allocated: 275724 }
+
+# ---------------------------------------------------------------------------
+# 5. PÚBLICO LOCAL, ENTIDADES FEDERATIVAS (non-border) — added by the
+#    verification pass, 2026-08-02. Referenced by mx-public-car-2016
+#    (A-000-AAA).
+#
+#    THE DECODE KEY INVERTS, AND THIS IS THE MOST IMPORTANT SINGLE FACT IN
+#    THIS FILE. The private-car series carries the entity in its LEADING
+#    letter triple; the public-local car series carries it in the TRAILING
+#    triple. Two seven-character shapes, opposite decode keys. A parse API
+#    that reuses the private decoder on a public plate will confidently name
+#    the wrong state, every time.
+# ---------------------------------------------------------------------------
+public_entity:
+  - { code: MX-AGU, name: "Aguascalientes", car_from: "A-001-AAA", car_to: "Z-999-ACZ", car_allocated: 1585413 }
+  - { code: MX-BCN, name: "Baja California", car_from: "A-001-ADA", car_to: "Z-999-AUZ", car_allocated: 7927065 }
+  - { code: MX-BCS, name: "Baja California Sur", car_from: "A-001-AVA", car_to: "Z-999-BDZ", car_allocated: 4756239 }
+  - { code: MX-CAM, name: "Campeche", car_from: "A-001-BEA", car_to: "Z-999-BGZ", car_allocated: 1585413 }
+  - { code: MX-CHP, name: "Chiapas", car_from: "A-001-BHA", car_to: "Z-999-BVZ", car_allocated: 6341652 }
+  - { code: MX-CHH, name: "Chihuahua", car_from: "A-001-BWA", car_to: "Z-999-CSZ", car_allocated: 10569420 }
+  - { code: MX-COA, name: "Coahuila de Zaragoza", car_from: "A-001-CTA", car_to: "Z-999-DUZ", car_allocated: 13211775 }
+  - { code: MX-COL, name: "Colima", car_from: "A-001-DVA", car_to: "Z-999-DXZ", car_allocated: 1585413 }
+  - { code: MX-DUR, name: "Durango", car_from: "A-001-DYA", car_to: "Z-999-EFZ", car_allocated: 4227768 }
+  - { code: MX-GUA, name: "Guanajuato", car_from: "A-001-EGA", car_to: "Z-999-FEZ", car_allocated: 11626362 }
+  - { code: MX-GRO, name: "Guerrero", car_from: "A-001-FFA", car_to: "Z-999-FTZ", car_allocated: 6341652 }
+  - { code: MX-HID, name: "Hidalgo", car_from: "A-001-FUA", car_to: "Z-999-GLZ", car_allocated: 8984007 }
+  - { code: MX-JAL, name: "Jalisco", car_from: "A-001-GMA", car_to: "Z-999-JDZ", car_allocated: 20610369 }
+  - { code: MX-MEX, name: "México (Estado de)", car_from: "A-001-JEA", car_to: "Z-999-LAZ", car_allocated: 22724253 }
+  - { code: MX-MIC, name: "Michoacán de Ocampo", car_from: "A-001-LBA", car_to: "Z-999-LSZ", car_allocated: 7927065 }
+  - { code: MX-MOR, name: "Morelos", car_from: "A-001-LTA", car_to: "Z-999-MCZ", car_allocated: 5284710 }
+  - { code: MX-NAY, name: "Nayarit", car_from: "A-001-MDA", car_to: "Z-999-MJZ", car_allocated: 3170826 }
+  - { code: MX-NLE, name: "Nuevo León", car_from: "A-001-MKA", car_to: "Z-999-SHZ", car_allocated: 48090861 }
+  - { code: MX-OAX, name: "Oaxaca", car_from: "A-001-SJA", car_to: "Z-999-SRZ", car_allocated: 3699297 }
+  - { code: MX-PUE, name: "Puebla", car_from: "A-001-SSA", car_to: "Z-999-TFZ", car_allocated: 7398594 }
+  - { code: MX-QUE, name: "Querétaro", car_from: "A-001-TGA", car_to: "Z-999-TLZ", car_allocated: 2642355 }
+  - { code: MX-ROO, name: "Quintana Roo", car_from: "A-001-TMA", car_to: "Z-999-TRZ", car_allocated: 2113884 }
+  - { code: MX-SLP, name: "San Luis Potosí", car_from: "A-001-TSA", car_to: "Z-999-TUZ", car_allocated: 1585413 }
+  - { code: MX-SIN, name: "Sinaloa", car_from: "A-001-TVA", car_to: "Z-999-UNZ", car_allocated: 9512478 }
+  - { code: MX-SON, name: "Sonora", car_from: "A-001-UPA", car_to: "Z-999-VLZ", car_allocated: 11097891 }
+  - { code: MX-TAB, name: "Tabasco", car_from: "A-001-VMA", car_to: "Z-999-VRZ", car_allocated: 2113884 }
+  - { code: MX-TAM, name: "Tamaulipas", car_from: "A-001-VSA", car_to: "Z-999-WVZ", car_allocated: 14268717 }
+  - { code: MX-TLA, name: "Tlaxcala", car_from: "A-001-WWA", car_to: "Z-999-XBZ", car_allocated: 3170826 }
+  - { code: MX-VER, name: "Veracruz de Ignacio de la Llave", car_from: "A-001-XCA", car_to: "Z-999-YRZ", car_allocated: 19024956 }
+  - { code: MX-YUC, name: "Yucatán", car_from: "A-001-YSA", car_to: "Z-999-ZEZ", car_allocated: 6870123 }
+  - { code: MX-ZAC, name: "Zacatecas", car_from: "A-001-ZFA", car_to: "Z-999-ZKZ", car_allocated: 2642355 }
+public_entity_note: >-
+  The trailing triples skip I, O and Q exactly as the Apéndice C NOTA requires
+  — Oaxaca runs SJA..SRZ and not SIA.., Sonora runs UPA..VLZ and not UOA.. That
+  the allocation is internally consistent with its own charset rule is the best
+  available corroboration that this transcription is faithful, and it is the
+  check a verifier should re-run before trusting any row.
+public_entity_source: "https://www.dof.gob.mx/nota_detalle.php?codigo=5442476&fecha=24/06/2016  # Apéndice C, 'NUMERACIÓN DE LAS PLACAS ASIGNADAS A CADA ENTIDAD FEDERATIVA PÚBLICO LOCAL', AUTOMÓVILES column; accessed 2026-08-02"
+
+# ---------------------------------------------------------------------------
+# 6. POLICE ENTITY CODES — added by the verification pass, 2026-08-02.
+#
+#    THE ONE MEXICAN SERIES THAT PRINTS A LITERAL ENTITY CODE. Everywhere else
+#    in this file the state is recoverable only by range comparison; on a
+#    police plate it is the first two characters, and a human can read it off.
+#    Grammar AA-000A-0 for vehicles, AA00A for motorcycles (NOM Apéndice B
+#    Tabla C row 4). Each entity gets the whole space under its own pair —
+#    206,793 vehicle and 2,277 motorcycle combinations — so the code IS the
+#    decode and per-entity ranges add nothing.
+#
+#    THESE ARE NOT THE §5.1.4.2 LEGEND ABBREVIATIONS AND MUST NOT BE MERGED
+#    WITH THEM: Oaxaca is AX here and OAX/OC there; Querétaro is ER here and
+#    QRO/QT there; Quintana Roo is TR here and QR there. Mexico City's code is
+#    DF — a name abolished in 2016, surviving inside a 2016 instrument.
+# ---------------------------------------------------------------------------
+police_entity_codes:
+  - { code: MX-AGU, name: "Aguascalientes", plate_code: "AG" }
+  - { code: MX-BCN, name: "Baja California", plate_code: "BC" }
+  - { code: MX-BCS, name: "Baja California Sur", plate_code: "BS" }
+  - { code: MX-CAM, name: "Campeche", plate_code: "CM" }
+  - { code: MX-COA, name: "Coahuila de Zaragoza", plate_code: "CA" }
+  - { code: MX-COL, name: "Colima", plate_code: "CL" }
+  - { code: MX-CHP, name: "Chiapas", plate_code: "CS" }
+  - { code: MX-CHH, name: "Chihuahua", plate_code: "CH" }
+  - { code: MX-CMX, name: "Ciudad de México", plate_code: "DF" }
+  - { code: MX-DUR, name: "Durango", plate_code: "DG" }
+  - { code: MX-MEX, name: "México (Estado de)", plate_code: "ME" }
+  - { code: MX-GUA, name: "Guanajuato", plate_code: "GT" }
+  - { code: MX-GRO, name: "Guerrero", plate_code: "GR" }
+  - { code: MX-HID, name: "Hidalgo", plate_code: "HG" }
+  - { code: MX-JAL, name: "Jalisco", plate_code: "JA" }
+  - { code: MX-MIC, name: "Michoacán de Ocampo", plate_code: "MC" }
+  - { code: MX-MOR, name: "Morelos", plate_code: "MR" }
+  - { code: MX-NAY, name: "Nayarit", plate_code: "NA" }
+  - { code: MX-NLE, name: "Nuevo León", plate_code: "NL" }
+  - { code: MX-OAX, name: "Oaxaca", plate_code: "AX" }
+  - { code: MX-PUE, name: "Puebla", plate_code: "PB" }
+  - { code: MX-QUE, name: "Querétaro", plate_code: "ER" }
+  - { code: MX-ROO, name: "Quintana Roo", plate_code: "TR" }
+  - { code: MX-SLP, name: "San Luis Potosí", plate_code: "SL" }
+  - { code: MX-SIN, name: "Sinaloa", plate_code: "SA" }
+  - { code: MX-SON, name: "Sonora", plate_code: "SN" }
+  - { code: MX-TAB, name: "Tabasco", plate_code: "TB" }
+  - { code: MX-TAM, name: "Tamaulipas", plate_code: "TM" }
+  - { code: MX-TLA, name: "Tlaxcala", plate_code: "TL" }
+  - { code: MX-VER, name: "Veracruz de Ignacio de la Llave", plate_code: "VE" }
+  - { code: MX-YUC, name: "Yucatán", plate_code: "YU" }
+  - { code: MX-ZAC, name: "Zacatecas", plate_code: "ZA" }
+police_entity_codes_collision_warning: >-
+  VE is Veracruz's police code AND the fixed pair on manufacturer diagnostic
+  plates ("En la numeración de placas para vehículos de diagnóstico no se
+  modifican las letras 'VE'"). The two are separated by GRAMMAR, not by the
+  pair: police is AA-000A-0, diagnostic is AA-A000. A consumer that strips
+  separators before decoding must keep the shapes apart first.
+police_entity_codes_source: "https://www.dof.gob.mx/nota_detalle.php?codigo=5442476&fecha=24/06/2016  # Apéndice C, 'SERIES ASIGNADAS PARA LA POLICÍA DE LAS DIFERENTES ENTIDADES FEDERATIVAS Y LA CIUDAD DE MÉXICO', AUTOMÓVILES and MOTOCICLETAS columns (AG-001A-1..AG-999Z-9 and AG01A..AG99Z per entity); accessed 2026-08-02"
+
+# ---------------------------------------------------------------------------
+# 7. LEGEND ABBREVIATIONS — NOM §5.1.4.2, columns (A), (B) and (C). Added by
+#    the verification pass, 2026-08-02.
+#
+#    These are WORDS PRINTED ON THE PLATE, not part of any serial, and they are
+#    in this file only so nobody mistakes them for the police codes above.
+#    Column B is the traditional abbreviation; column C is the RENAPO-aligned
+#    catalogue code. The NOM permits either ("las posibles abreviaturas"), so a
+#    renderer must be able to set both.
+#
+#    COLLISION IN THE PRIMARY, recorded not repaired: COLIMA and CIUDAD DE
+#    MÉXICO both carry the column-C code CM.
+# ---------------------------------------------------------------------------
+legend_abbreviations:
+  - { code: MX-AGU, option1: "AGS",  renapo: "AS" }
+  - { code: MX-BCN, option1: "BC",   renapo: "BC" }
+  - { code: MX-BCS, option1: "BCS",  renapo: "BS" }
+  - { code: MX-CAM, option1: "CAMP", renapo: "CC" }
+  - { code: MX-COA, option1: "COAH", renapo: "CL" }
+  - { code: MX-COL, option1: "COL",  renapo: "CM" }
+  - { code: MX-CHP, option1: "CHIS", renapo: "CS" }
+  - { code: MX-CHH, option1: "CHIH", renapo: "CH" }
+  - { code: MX-CMX, option1: "CDMX", renapo: "CM" }
+  - { code: MX-DUR, option1: "DGO",  renapo: "DG" }
+  - { code: MX-GUA, option1: "GTO",  renapo: "GT" }
+  - { code: MX-GRO, option1: "GRO",  renapo: "GR" }
+  - { code: MX-HID, option1: "HGO",  renapo: "HG" }
+  - { code: MX-JAL, option1: "JAL",  renapo: "JC" }
+  - { code: MX-MEX, option1: "MEX",  renapo: "MC" }
+  - { code: MX-MIC, option1: "MICH", renapo: "MN" }
+  - { code: MX-MOR, option1: "MOR",  renapo: "MS" }
+  - { code: MX-NAY, option1: "NAY",  renapo: "NT" }
+  - { code: MX-NLE, option1: "NL",   renapo: "NL" }
+  - { code: MX-OAX, option1: "OAX",  renapo: "OC" }
+  - { code: MX-PUE, option1: "PUE",  renapo: "PL" }
+  - { code: MX-QUE, option1: "QRO",  renapo: "QT" }
+  - { code: MX-ROO, option1: "QR",   renapo: "QR" }
+  - { code: MX-SLP, option1: "SLP",  renapo: "SP" }
+  - { code: MX-SIN, option1: "SIN",  renapo: "SL" }
+  - { code: MX-SON, option1: "SON",  renapo: "SR" }
+  - { code: MX-TAB, option1: "TAB",  renapo: "TC" }
+  - { code: MX-TAM, option1: "TAMP", renapo: "TS" }
+  - { code: MX-TLA, option1: "TLAX", renapo: "TL" }
+  - { code: MX-VER, option1: "VER",  renapo: "VZ" }
+  - { code: MX-YUC, option1: "YUC",  renapo: "YN" }
+  - { code: MX-ZAC, option1: "ZAC",  renapo: "ZS" }
+legend_abbreviations_source: "https://www.dof.gob.mx/nota_detalle.php?codigo=5442476&fecha=24/06/2016  # §5.1.4.2: 'El nombre y las posibles abreviaturas que deben emplear las Entidades Federativas se indica en las columnas A, B y C de la siguiente Tabla.'; accessed 2026-08-02"
+
+# ---------------------------------------------------------------------------
+# 8. RESERVED LETTER TOKENS — added by the verification pass, 2026-08-02.
+#    Small, closed, and each one is a ONE-SHOT identification for a parse API,
+#    which is why they belong beside the ranges rather than buried in a series
+#    note. Every one is fixed by an express NOTA in Apéndice C or spelled
+#    literally in Tabla C.
+# ---------------------------------------------------------------------------
+reserved_letter_tokens:
+  - token: "D"
+    applies_to: "Convertidor (Dolly), federal, grammar A-00-000"
+    quote: "NOTA: En la numeración de placas para convertidor (Dolly) no se modifica la letra “D”."
+  - token: "VE"
+    applies_to: "Vehículos de diagnóstico (manufacturer road-test), grammar AA-A000"
+    quote: "NOTA: En la numeración de placas para vehículos de diagnóstico no se modifican las letras “VE”."
+  - token: "MT"
+    applies_to: "Traslado Nacional motocicletas, grammar AA000A, whole national range MT001A-MT999Z (22,977)"
+    quote: "NOTA: En la numeración de placas para traslado de motocicleta no se modifican las letras “MT”."
+  - token: "DM"
+    applies_to: "Demostración, Ciudad de México, grammar DM-AA-0 — spelled literally in Tabla C itself"
+    quote: "Tabla C, Apéndice B: 6.- Transporte Privado — Demostración, Ciudad de México (Todo tipo de vehículos) — DM-AA-0"
+  - token: "AM"
+    applies_to: "Ambulancias, grammar AA-000-AA; the pair is fixed by the ALLOCATION, not by Tabla C, which writes it generically"
+    quote: "Apéndice C, AMBULANCIA: AGUASCALIENTES AM-001-AA - AM-879-AS ... ZACATECAS AM-600-ZP - AM-999-ZZ"
+  - token: "BM"
+    applies_to: "Bomberos, grammar AA-000-AA; same basis as AM"
+    quote: "Apéndice C, BOMBEROS: AGUASCALIENTES BM-001-AA - BM-879-AS ... ZACATECAS BM-600-ZP - BM-999-ZZ"
+  - token: "PC"
+    applies_to: "Protección Civil, grammar 00-AA-000; and the LEADING DIGIT PAIR is the entity's fiscal number 01-32, which makes this the only Mexican series with a NUMERIC geographic decode"
+    quote: "Apéndice C, PROTECCIÓN CIVIL: AGUASCALIENTES 01-PC-001 - 01-PC-999 ... ZACATECAS 32-PC-001 - 32-PC-999"
+reserved_letter_tokens_source: "https://www.dof.gob.mx/nota_detalle.php?codigo=5442476&fecha=24/06/2016  # the NOTA lines and the AM/BM/PC allocation tables in Apéndice C; Tabla C in Apéndice B for the DM token; accessed 2026-08-02"
+
+# ---------------------------------------------------------------------------
+# 9. VERIFICATION RECORD — independent second transcription, 2026-08-02.
+# ---------------------------------------------------------------------------
+verification:
+  method: >-
+    The whole of Apéndice C was re-extracted independently from a SECOND
+    federal copy of the instrument — the Secretaría de Economía NOM repository
+    PDF at http://www.economia-noms.gob.mx/normas/noms/2010/001sct22016.pdf,
+    86 pages, text-extracted with `pdftotext -layout` and parsed by script —
+    and the resulting rows were compared against sections 1 to 4 of this file
+    row by row.
+  result: >-
+    AGREEMENT on every private-car range, every Ciudad de México range, and
+    every border range checked. Two independent transcriptions of a scanned
+    federal instrument agreeing is the strongest evidence available short of
+    the DOF facsimile itself.
+  anomalies_found:
+    - >-
+      MORELOS private-TRUCK row (section 1): the instrument prints
+      "UN-0001-A - NZ-9999-Z", whose end sorts BEFORE its start in the NOM's
+      own 23-letter alphabet. Both transcriptions read it identically, so the
+      defect is in the instrument or in its DOF type-setting, not in the
+      extraction. It is recorded, not repaired. A verifier with the DOF
+      facsimile should settle it; until then no consumer should range-decode a
+      Mexican private truck through that row.
+    - >-
+      PRINTED ORDER IS NOT MONOTONIC IN `from`. Apéndice C prints entities in
+      SPANISH alphabetical order, in which CH sorts as its own letter, so
+      Chiapas and Chihuahua precede Coahuila; and the Estado de México and
+      Michoacán blocks (LGA.. and PFA..) sit between Jalisco and Morelos in
+      letter space while being printed at their alphabetical positions. A
+      consumer MUST sort by `from` and must not assume row order. Sorted, the
+      blocks are contiguous and non-overlapping — which is the first check a
+      verifier should run.
+  not_transcribed: >-
+    Apéndice C also carries per-entity allocations for autobuses, remolques,
+    convertidores, motocicletas (three grammars), demostración, ecológicos,
+    ambulancias, bomberos, protección civil and escoltas. They are sourced at
+    exactly the same quality and are omitted for scope (PRD-PLATES §2.5).
+    Extending this file needs no new sourcing, only transcription.