vehicles 0.6.1 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (186) hide show
  1. checksums.yaml +4 -4
  2. data/.rubocop_todo.yml +164 -0
  3. data/CHANGELOG.md +274 -0
  4. data/README.md +55 -10
  5. data/data/PROVENANCE-vehicles.md +12 -0
  6. data/data/plates/PROVENANCE.md +5 -4
  7. data/data/plates/_decode/at-districts.yml +287 -0
  8. data/data/plates/_decode/ch-cantons.yml +110 -0
  9. data/data/plates/_decode/cn-issuing-offices.yml +463 -0
  10. data/data/plates/_decode/cn-provinces.yml +614 -0
  11. data/data/plates/_decode/cz-kraj.yml +159 -0
  12. data/data/plates/_decode/dk-serial-blocks.yml +327 -0
  13. data/data/plates/_decode/fr-departements.yml +191 -0
  14. data/data/plates/_decode/gb-age-identifiers.yml +170 -0
  15. data/data/plates/_decode/gb-memory-tags.yml +202 -0
  16. data/data/plates/_decode/gr-prefectures.yml +1408 -0
  17. data/data/plates/_decode/hr-cities.yml +315 -0
  18. data/data/plates/_decode/ie-counties.yml +227 -0
  19. data/data/plates/_decode/in-state-codes.yml +169 -0
  20. data/data/plates/_decode/is-districts-1938.yml +116 -0
  21. data/data/plates/_decode/it-provinces.yml +348 -0
  22. data/data/plates/_decode/jp-office-marks.yml +960 -0
  23. data/data/plates/_decode/jp-use-marks.yml +205 -0
  24. data/data/plates/_decode/kr-authority-marks.yml +146 -0
  25. data/data/plates/_decode/kr-use-syllables.yml +194 -0
  26. data/data/plates/_decode/lu-series-order.yml +638 -0
  27. data/data/plates/_decode/mx-entity-series.yml +380 -0
  28. data/data/plates/_decode/my-index-marks.yml +271 -0
  29. data/data/plates/_decode/no-counties-1913.yml +148 -0
  30. data/data/plates/_decode/no-districts.yml +901 -0
  31. data/data/plates/_decode/pl-powiats.yml +567 -0
  32. data/data/plates/_decode/pt-trailer-services.yml +96 -0
  33. data/data/plates/_decode/ro-counties.yml +213 -0
  34. data/data/plates/_decode/se-diplomatic.yml +220 -0
  35. data/data/plates/_decode/si-regions.yml +123 -0
  36. data/data/plates/_decode/sk-districts.yml +314 -0
  37. data/data/plates/_decode/th-registration-elements.yml +208 -0
  38. data/data/plates/_decode/ua-regions.yml +393 -0
  39. data/data/plates/_decode/za-licence-marks.yml +215 -0
  40. data/data/plates/_meta/classes.yml +1 -0
  41. data/data/plates/_meta/separators.yml +102 -0
  42. data/data/plates/ad.yml +961 -0
  43. data/data/plates/ar.yml +762 -0
  44. data/data/plates/at.yml +1424 -0
  45. data/data/plates/au-act.yml +472 -0
  46. data/data/plates/au-nsw.yml +282 -0
  47. data/data/plates/au-nt.yml +431 -0
  48. data/data/plates/au-qld.yml +272 -0
  49. data/data/plates/au-sa.yml +248 -0
  50. data/data/plates/au-tas.yml +302 -0
  51. data/data/plates/au-vic.yml +215 -0
  52. data/data/plates/au-wa.yml +309 -0
  53. data/data/plates/be.yml +1840 -0
  54. data/data/plates/br.yml +1152 -0
  55. data/data/plates/ca-ab.yml +430 -0
  56. data/data/plates/ca-bc.yml +697 -0
  57. data/data/plates/ca-mb.yml +499 -0
  58. data/data/plates/ca-nb.yml +537 -0
  59. data/data/plates/ca-nl.yml +743 -0
  60. data/data/plates/ca-ns.yml +808 -0
  61. data/data/plates/ca-nt.yml +610 -0
  62. data/data/plates/ca-nu.yml +280 -0
  63. data/data/plates/ca-on.yml +881 -0
  64. data/data/plates/ca-pe.yml +592 -0
  65. data/data/plates/ca-qc.yml +1036 -0
  66. data/data/plates/ca-sk.yml +256 -0
  67. data/data/plates/ca-yt.yml +656 -0
  68. data/data/plates/ch.yml +1273 -0
  69. data/data/plates/cn.yml +1431 -0
  70. data/data/plates/cy.yml +688 -0
  71. data/data/plates/cz.yml +1179 -0
  72. data/data/plates/de.yml +553 -118
  73. data/data/plates/dk.yml +1647 -0
  74. data/data/plates/ee.yml +1275 -0
  75. data/data/plates/es.yml +228 -32
  76. data/data/plates/fi.yml +1271 -0
  77. data/data/plates/fr.yml +1265 -0
  78. data/data/plates/gb.yml +1188 -0
  79. data/data/plates/gr.yml +721 -0
  80. data/data/plates/hr.yml +860 -0
  81. data/data/plates/hu.yml +959 -0
  82. data/data/plates/ie.yml +775 -0
  83. data/data/plates/in.yml +1172 -0
  84. data/data/plates/is.yml +667 -0
  85. data/data/plates/it.yml +1317 -0
  86. data/data/plates/jp.yml +3650 -0
  87. data/data/plates/kr.yml +1375 -0
  88. data/data/plates/li.yml +1010 -0
  89. data/data/plates/lt.yml +879 -0
  90. data/data/plates/lu.yml +842 -0
  91. data/data/plates/lv.yml +924 -0
  92. data/data/plates/mc.yml +1024 -0
  93. data/data/plates/mt.yml +854 -0
  94. data/data/plates/mx.yml +1372 -0
  95. data/data/plates/my.yml +685 -0
  96. data/data/plates/nl.yml +44 -0
  97. data/data/plates/no.yml +1018 -0
  98. data/data/plates/nz.yml +1699 -0
  99. data/data/plates/pl.yml +1296 -0
  100. data/data/plates/pt.yml +847 -0
  101. data/data/plates/ro.yml +785 -0
  102. data/data/plates/se.yml +1091 -0
  103. data/data/plates/si.yml +1105 -0
  104. data/data/plates/sk.yml +1439 -0
  105. data/data/plates/sm.yml +1119 -0
  106. data/data/plates/th.yml +1150 -0
  107. data/data/plates/ua.yml +1672 -0
  108. data/data/plates/us-ak.yml +763 -0
  109. data/data/plates/us-al.yml +457 -0
  110. data/data/plates/us-ar.yml +427 -0
  111. data/data/plates/us-as.yml +454 -0
  112. data/data/plates/us-az.yml +430 -0
  113. data/data/plates/us-ca.yml +892 -0
  114. data/data/plates/us-co.yml +452 -0
  115. data/data/plates/us-ct.yml +427 -0
  116. data/data/plates/us-dc.yml +614 -0
  117. data/data/plates/us-de.yml +551 -0
  118. data/data/plates/us-fl.yml +319 -96
  119. data/data/plates/us-ga.yml +644 -0
  120. data/data/plates/us-gu.yml +658 -0
  121. data/data/plates/us-hi.yml +585 -0
  122. data/data/plates/us-ia.yml +438 -0
  123. data/data/plates/us-id.yml +531 -0
  124. data/data/plates/us-il.yml +516 -0
  125. data/data/plates/us-in.yml +324 -0
  126. data/data/plates/us-ks.yml +351 -0
  127. data/data/plates/us-ky.yml +770 -0
  128. data/data/plates/us-la.yml +568 -0
  129. data/data/plates/us-ma.yml +379 -0
  130. data/data/plates/us-md.yml +536 -0
  131. data/data/plates/us-me.yml +445 -0
  132. data/data/plates/us-mi.yml +408 -0
  133. data/data/plates/us-mn.yml +411 -0
  134. data/data/plates/us-mo.yml +356 -0
  135. data/data/plates/us-mp.yml +402 -0
  136. data/data/plates/us-ms.yml +432 -0
  137. data/data/plates/us-mt.yml +619 -0
  138. data/data/plates/us-nc.yml +602 -0
  139. data/data/plates/us-nd.yml +419 -0
  140. data/data/plates/us-ne.yml +483 -0
  141. data/data/plates/us-nh.yml +394 -0
  142. data/data/plates/us-nj.yml +547 -0
  143. data/data/plates/us-nm.yml +574 -0
  144. data/data/plates/us-nv.yml +655 -0
  145. data/data/plates/us-ny.yml +592 -0
  146. data/data/plates/us-oh.yml +404 -0
  147. data/data/plates/us-ok.yml +513 -0
  148. data/data/plates/us-or.yml +392 -0
  149. data/data/plates/us-pa.yml +506 -0
  150. data/data/plates/us-pr.yml +507 -0
  151. data/data/plates/us-ri.yml +445 -0
  152. data/data/plates/us-sc.yml +605 -0
  153. data/data/plates/us-sd.yml +428 -0
  154. data/data/plates/us-tn.yml +471 -0
  155. data/data/plates/us-tx.yml +535 -0
  156. data/data/plates/us-ut.yml +384 -0
  157. data/data/plates/us-va.yml +567 -0
  158. data/data/plates/us-vi.yml +489 -0
  159. data/data/plates/us-vt.yml +458 -0
  160. data/data/plates/us-wa.yml +484 -0
  161. data/data/plates/us-wi.yml +509 -0
  162. data/data/plates/us-wv.yml +446 -0
  163. data/data/plates/us-wy.yml +523 -0
  164. data/data/plates/va.yml +604 -0
  165. data/data/plates/za.yml +1141 -0
  166. data/data/vehicles.json +160653 -105090
  167. data/lib/vehicles/configuration.rb +17 -3
  168. data/lib/vehicles/dataset.rb +73 -18
  169. data/lib/vehicles/fuzzy.rb +115 -0
  170. data/lib/vehicles/http.rb +48 -0
  171. data/lib/vehicles/make.rb +36 -6
  172. data/lib/vehicles/mcp_server.rb +5 -5
  173. data/lib/vehicles/model.rb +21 -2
  174. data/lib/vehicles/plates/series.rb +172 -18
  175. data/lib/vehicles/plates/template_fill.rb +188 -0
  176. data/lib/vehicles/plates/templates.rb +162 -0
  177. data/lib/vehicles/plates.rb +12 -0
  178. data/lib/vehicles/providers/hosted_provider.rb +28 -55
  179. data/lib/vehicles/validators/vehicle_make_validator.rb +3 -1
  180. data/lib/vehicles/validators/vehicle_model_validator.rb +1 -1
  181. data/lib/vehicles/version.rb +1 -1
  182. data/lib/vehicles.rb +32 -16
  183. data/rakelib/data_refresh.rake +109 -0
  184. data/rakelib/plates_refresh.rake +29 -0
  185. data/sig/vehicles.rbs +18 -0
  186. metadata +164 -2
@@ -0,0 +1,454 @@
1
+ # plates/us-as.yml — American Samoa (PRD-PLATES gate L2, territories group).
2
+ #
3
+ # AMERICAN SAMOA CARRIES THE MOST CONSEQUENTIAL LEGAL FINDING IN THE ENTIRE US
4
+ # PASS, AND IT IS NOT ABOUT PLATES. The United States Copyright Office states
5
+ # that "US federal copyright law applies in the US Virgin Islands, Guam, and the
6
+ # Northern Mariana Islands BUT NOT IN AMERICAN SAMOA", because 17 U.S.C. § 101's
7
+ # geographical definition of "the United States" reaches the several States, the
8
+ # District of Columbia, and the ORGANIZED territories — and American Samoa is
9
+ # unorganized and unincorporated. American Samoa therefore sits OUTSIDE the
10
+ # geographic scope of the Copyright Act. That is a stronger position than
11
+ # Florida's, which rests on state constitutional law and a 2004 decision; here
12
+ # the federal statute simply does not reach. See `artwork_risk`.
13
+ #
14
+ # THE PLATE LAW ITSELF IS THE THINNEST IN THE GROUP AND THIS FILE SAYS SO
15
+ # THROUGHOUT. Title 22 of the American Samoa Code Annotated, Chapter 10
16
+ # ("Vehicle Licensing and Registration"), is SEVEN SECTIONS LONG — 22.1001 to
17
+ # 22.1007 — and legislates the number of tags, where they go, how they are
18
+ # validated and what they cost. It legislates NOTHING about format, colour,
19
+ # dimension, class prefixes or specialty programmes. Every claim below is
20
+ # either from those seven sections or is marked as secondary.
21
+ #
22
+ # WHAT IS DELIBERATELY NOT HERE (PRD-PLATES §2.5): individual specialty DESIGNS.
23
+ jurisdiction: us-as
24
+ authority:
25
+ name: American Samoa Department of Public Safety — Office of Motor Vehicles (the "Commissioner" of A.S.C.A. Title 22)
26
+ url: "https://asbar.org/section/title-22-highways-and-motor-vehicles/chapter-10-vehicle-licensing-and-registration/"
27
+ binding: vehicle
28
+ statute_edition: >-
29
+ American Samoa Code Annotated, Title 22 ("Highways and Motor Vehicles"),
30
+ Chapter 10, as served by the American Samoa Bar Association — the standing
31
+ public host of the ASCA. The Bar's own code index is captioned "Updated
32
+ Annotated Code by Title (as of August 2021)", so the served text is a 2021
33
+ compilation and later amendments were NOT checked (recorded gap).
34
+ authority_url_note: >-
35
+ American Samoa's Department of Public Safety publishes no reachable motor
36
+ vehicle page, and americansamoa.gov, while reachable, surfaced no plate
37
+ content. The authority URL therefore points at the statutory chapter itself,
38
+ which is the primary-source home of every claim in this file. The
39
+ "Commissioner" named throughout Chapter 10 is the officer the 1977 amendment
40
+ substituted for the "Treasurer", per the Bar's own amendment note.
41
+
42
+ # ---------------------------------------------------------------------------
43
+ # artwork_risk — required per jurisdiction by PRD-PLATES §4 / §7.1.
44
+ # THIS IS THE STRONGEST POSTURE IN THE US DATASET AND IT DESERVES ITS SPACE.
45
+ # ---------------------------------------------------------------------------
46
+ artwork_risk:
47
+ posture: outside-us-copyright-scope
48
+ basis: >-
49
+ American Samoa is the only US jurisdiction in this dataset where the question
50
+ is not "does this government claim copyright?" but "does the Copyright Act
51
+ reach here at all?" — and the answer, from the US Copyright Office, is no.
52
+ Wikimedia Commons quotes the position directly: US copyright law "applies in
53
+ all 50 states, the District of Columbia, Puerto Rico, the US Virgin Islands,
54
+ Guam, and the Northern Mariana Islands, BUT DOES NOT APPLY IN AMERICAN
55
+ SAMOA", grounding it in 17 U.S.C. § 101's definition of "the United States"
56
+ in a geographical sense, which reaches the several States, DC and the
57
+ ORGANIZED territories under US jurisdiction. American Samoa is UNORGANIZED
58
+ and unincorporated and is therefore excluded. Commons operationalises this
59
+ with a dedicated tag, {{PD-American Samoa}}, "used for works made in American
60
+ Samoa so long as the work has not been copyrighted elsewhere in the United
61
+ States", and maintains a country-specific rules page for the territory.
62
+ caveat: >-
63
+ STATED SO THE POSTURE IS NOT OVERREAD. The exclusion is GEOGRAPHIC, and the
64
+ Commons tag's own condition preserves the limit: a work made in American
65
+ Samoa is treated as public domain "SO LONG AS THE WORK HAS NOT BEEN
66
+ COPYRIGHTED ELSEWHERE IN THE UNITED STATES". A plate design commissioned
67
+ from, or first fixed by, a mainland or Hawaii-based manufacturer could
68
+ therefore be protected notwithstanding the territorial exclusion, and nothing
69
+ in this pass establishes where American Samoa's plate artwork was authored.
70
+ Additionally, no American Samoa territorial copyright statute was searched for
71
+ successfully, so whether the territory has enacted its own protection regime
72
+ is UNRESEARCHED — the federal Act's silence is not the same as a legal vacuum.
73
+ conclusion: >-
74
+ Treat American Samoa as the most favourable artwork posture in the US
75
+ dataset, ahead of Florida, but do NOT treat it as unconditional. The
76
+ conditions above are real and unresolved. The practical consequence for this
77
+ programme is that American Samoa is the strongest candidate anywhere in the
78
+ US for an EMBLEM-SLOT UPGRADE under PRD-PLATES §7.1 — where artwork_risk and
79
+ the _art ledger must both clear, this jurisdiction clears the first test on
80
+ stronger grounds than any state does.
81
+ edicts: >-
82
+ Independent of all of the above, edicts of government are public domain at
83
+ every level ({{PD-US-GovEdict}}), so A.S.C.A. Title 22 is free to use
84
+ regardless of how the territorial-scope question resolves.
85
+ emblem_rule: >-
86
+ PRD-PLATES §3's placeholder default STILL APPLIES for now, and deliberately:
87
+ the favourable copyright position does not touch the separate protection
88
+ regimes for flags and seals, and the caveat above is unresolved. Render
89
+ `emblem: {present: true, rendered: placeholder}` — but flag this jurisdiction
90
+ to the art-tier owner as the highest-value place to do the affirmative
91
+ clearance work, because the upside here is larger than anywhere else.
92
+ photograph_caution: >-
93
+ plateshack.com and worldlicenseplates.com carry no reusable licence and are
94
+ treated as all rights reserved; no image was copied. Note the sharp
95
+ distinction that matters here: even in a jurisdiction outside the Copyright
96
+ Act's scope, a PHOTOGRAPH taken elsewhere and uploaded by a mainland
97
+ contributor carries that photographer's own copyright under the law of the
98
+ place it was made. The territorial exclusion frees the DESIGN question, never
99
+ the PHOTOGRAPH question, and our own-SVG rule keeps the two apart.
100
+ sources:
101
+ - "https://commons.wikimedia.org/wiki/Commons:Copyright_rules_by_territory/United_States # THE FINDING: the US Copyright Office position that federal copyright law does NOT apply in American Samoa, quoted with its 17 U.S.C. § 101 basis; the US Territories tag list; and the pointer to Commons:Copyright rules by territory/American Samoa"
102
+ - "https://commons.wikimedia.org/wiki/Template:PD-American_Samoa # the dedicated Commons tag exists and is a primary licence tag, with its 'not copyrighted elsewhere in the United States' condition"
103
+ - "https://asbar.org/section/title-22-highways-and-motor-vehicles/chapter-10-vehicle-licensing-and-registration/ # A.S.C.A. Title 22 ch. 10 — an edict of government, PD at every level"
104
+
105
+ # ---------------------------------------------------------------------------
106
+ # The US standards chain. NOTHING here quotes SAE J686 (paywalled, unpinned).
107
+ # ---------------------------------------------------------------------------
108
+ us_standards:
109
+ no_federal_mandate: true
110
+ american_samoa_position: >-
111
+ A.S.C.A. Title 22 references no external standard and legislates no
112
+ dimension. It does legislate its own LEGIBILITY DISTANCE — 22.1003(1)
113
+ requires the tags to be "plainly visible for a distance of 50 feet" — which
114
+ is the same figure the CNMI legislates and two thirds of AAMVA's recommended
115
+ 75 feet. Two Pacific territories independently landing on 50 feet is worth
116
+ noting; whether that is common drafting ancestry or coincidence is unresolved.
117
+ aamva_edition_3:
118
+ dimensions_delegated: "AAMVA §3.1 delegates dimensions and bolt holes to SAE J686, whose text is PAYWALLED and was NOT obtained. No J686 dimension is quoted here."
119
+ retroreflectivity: "AAMVA §3.3 recommends readability from at least 75 feet in both daylight and darkness. American Samoa legislates 50 feet plus a separate ILLUMINATION duty (22.1003(2), cross-referring to 22.1101(e)), which is a different and arguably more precise way of reaching the night-time case than a reflectivity spec"
120
+ character_layout: "AAMVA §2.2: characters at least 2.5 in high, spaced at least 0.25 in apart, stroke weight 0.2-0.4 in"
121
+ replacement_cycle: "AAMVA §1.1 recommends a 7-10 year replacement cycle. American Samoa legislates a REPLACEMENT TRIGGER instead of a cycle: 22.1002(f) issues two new tags only to an applicant registering a vehicle not registered in the Territory in the PRECEDING FIVE YEARS, or whose tags were lost or stolen. Tags otherwise persist indefinitely behind annual decals"
122
+ source: "https://www.aamva.org/getmedia/646bcc8a-219b-47d8-b5cd-726240473163/License-Plate-Standard-Edition-3_September-2025-Update.pdf"
123
+
124
+ # ---------------------------------------------------------------------------
125
+ # Display rules — statutory, and American Samoa uses the term "LICENSE TAGS"
126
+ # rather than "license plates" throughout, which is preserved here.
127
+ # ---------------------------------------------------------------------------
128
+ display_rules:
129
+ default: >-
130
+ TWO tags, front and rear. 22.1003, verbatim: "License tags shall be displayed
131
+ only on the vehicle for which they were issued, and in the following manner:
132
+ (1) ONE FIRMLY ATTACHED TO THE FRONT AND THE OTHER FIRMLY ATTACHED TO THE
133
+ REAR of the vehicle at all times, which shall at all times be kept clean and
134
+ PLAINLY VISIBLE FOR A DISTANCE OF 50 FEET; (2) the license tags shall be
135
+ PROPERLY ILLUMINATED in accordance with subsection (e) of 22.1101."
136
+ tag_issuance: >-
137
+ 22.1002(f): the Commissioner issues TWO license tags to each applicant who is
138
+ either (1) registering a vehicle not registered in the Territory in the
139
+ preceding FIVE YEARS, or (2) whose tags have been lost or stolen, on proof.
140
+ Replacement of lost or stolen tags costs $22.00. So American Samoa does NOT
141
+ reissue tags at every registration — a returning vehicle keeps its tags, and
142
+ the five-year rule is the only routine trigger for new metal.
143
+ validation: >-
144
+ DECALS ON THE TAGS, not a windshield sticker. 22.1002(c): on satisfactory
145
+ compliance "the Commissioner shall issue 2 DECALS to the applicant WHICH
146
+ DECALS DENOMINATE THE PERIOD FOR WHICH REGISTRATION IS EFFECTIVE AND ARE TO BE
147
+ PLACED ON THE LICENSE TAGS." Two decals for two tags. Photographic evidence
148
+ corroborates month-and-year decals (January 2024, October 2023, August 2019,
149
+ January 2017 among many) and, notably, TAGS CARRYING SEVERAL YEARS' DECALS AT
150
+ ONCE — "August 2019 through August 21 expirations" and "January 2017 through
151
+ January 2023 expirations" on single plates — which is exactly what the
152
+ five-year reissue rule predicts.
153
+ expiration: "22.1004: all motor vehicle licenses expire annually at times designated by the Commissioner by rule; the Commissioner may allow up to 30 days' grace to obtain the inspection certificate"
154
+ registration_conditions: >-
155
+ 22.1002(b): no license issues without (1) payment of the fee, (2) a valid
156
+ inspection certificate under 22.1201 et seq., (3) certification of insurance
157
+ effective for the licence period under 22.2001 et seq., and (4) issuance of a
158
+ valid motor vehicle registration. American Samoa's courts have described this
159
+ as effectively conditioning use of the public highways on maintaining
160
+ insurance (Pu'u v. Lepule, 8 A.S.R.2d 68 (1988)).
161
+ requirement: "22.1001: 'No motor vehicle may be operated on any highway in American Samoa without a valid registration and VEHICLE LICENSE TAGS as required by this chapter.'"
162
+ sources:
163
+ - "https://asbar.org/code-annotated/22-1003-display-of-license/ # 22.1003 (1972, PL 12-65 § 1): one tag front, one rear, at all times, clean, plainly visible at 50 feet, properly illuminated per 22.1101(e)"
164
+ - "https://asbar.org/code-annotated/22-1002-application-for-and-issuance-of-license-fees/ # 22.1002: (b) the four preconditions; (c) two decals denominating the registration period, placed ON the tags; (d) the fee schedule; (f) two tags on first registration or after five years' absence, or on proof of loss or theft, $22.00 replacement; (g) $7.00 of each fee to a DPS law-enforcement and production fund"
165
+ - "https://asbar.org/code-annotated/22-1004-expiration-of-license/ # 22.1004 (1972, PL 12-65 § 1; amended 1977, PL 15-41 § 2): annual expiry at times set by the Commissioner by rule, up to 30 days' inspection grace, and the Bar's note that the 1977 amendment substituted 'Commissioner' for 'Treasurer'"
166
+ - "https://asbar.org/code-annotated/22-1001-motor-vehicle-registration-and-license-required/ # 22.1001 (1972, PL 12-65 § 1): the operating prohibition, plus the annotated case notes including Pu'u v. Lepule, 8 A.S.R.2d 68 (1988) and Foma'i v. Samana, 4 A.S.R.2d 102 (1987)"
167
+
168
+ series:
169
+
170
+ # =========================================================================
171
+ # THE STANDARD-ISSUE SERIES. American Samoa is the only jurisdiction in the
172
+ # territories group with an ALL-NUMERIC standard serial.
173
+ # =========================================================================
174
+ - id: us-as-standard
175
+ class: standard
176
+ categories: [car, van, truck, bus, motorcycle, trailer]
177
+ period: { start: 1972 }
178
+ period_evidence: statutory-enactment-date-upper-bound
179
+ matching: strict
180
+ format:
181
+ pattern: "9999"
182
+ regex: '\A\d+\z'
183
+ charset:
184
+ notes: >-
185
+ A.S.C.A. TITLE 22 STATES NO SERIAL GRAMMAR AT ALL — not an alphabet, not
186
+ a width, not an exclusion. The all-numeric form is reported by a
187
+ Wikipedia locator (four digits, continuously since 1967) and
188
+ independently corroborated by worldlicenseplates' American Samoa plate
189
+ history. The regex therefore claims a FORM (numeric) and makes NO WIDTH
190
+ CLAIM, exactly as us-fl-horseless-carriage does for the same reason: an
191
+ unbounded quantifier is the honest encoding of a statute that fixes no
192
+ width. There is no `regex_statutory` because there is no statutory bound
193
+ to encode.
194
+ pattern_note: >-
195
+ The pattern shows the four-digit form the sources report. `matching:
196
+ strict` because an all-numeric serial lies inside the (empty) statutory
197
+ constraint and a match is a real claim about this series.
198
+ progression: "the locator reports the range 0001 to 9999 — a single flat numeric space with no block structure, which is what a territory of American Samoa's fleet size would be expected to need"
199
+ design:
200
+ plate: { w: 12, h: 6, unit: in, w_mm: 304.8, h_mm: 152.4 }
201
+ plate_dimension_note: >-
202
+ NOT IN ANY AMERICAN SAMOA INSTRUMENT. 12 x 6 in aluminium is
203
+ locator-reported, together with the claim that American Samoa first issued
204
+ a 6 x 12 in plate in 1977 — i.e. that it adopted the North American
205
+ convention LATE, five years after the current licensing chapter was
206
+ enacted. That is an interesting claim and it is NOT asserted here; the
207
+ locator attributes it to a collector-journal article (Garrish, C.,
208
+ "Reconsidering the Standard Plate Size", Plates 62(5), October 2016) which
209
+ was not obtained. Recorded as a lead, not a fact.
210
+ background: { finish: retroreflective }
211
+ colour_note: >-
212
+ NO HEX IS RECORDED. The locator describes the current base as "black on
213
+ reflective graphic featuring Fatu Rock" — a GRAPHIC background, not a flat
214
+ colour, which is precisely the case where assigning a single background hex
215
+ would be inventing data. The foreground is described as black but no
216
+ instrument states it. Both are left absent with their descriptions
217
+ recorded.
218
+ foreground_description: "black (locator-grade)"
219
+ legend_top: "AMERICAN SAMOA"
220
+ legend_slogan_reported: "Motu O Fiafiaga"
221
+ legend_slogan_note: >-
222
+ The locator glosses this as "Island of Paradise". It is Samoan and it is
223
+ reported, not sourced — no American Samoa instrument prescribes any legend,
224
+ unlike Guam, where 16 GCA § 7120(b) puts the word "Guam" on every plate by
225
+ law, or the CNMI, where 9 CMC § 2116(c)(1) confirms the HAFA ADAI line.
226
+ graphic: { present: true, rendered: placeholder, description: "Fatu Rock (Fatu ma Futi) scenic graphic across the plate face — locator-grade description, from no instrument and no drawing" }
227
+ emblem: { present: true, rendered: placeholder }
228
+ band: { side: none }
229
+ rear_differs: false
230
+ validation: "two decals per registration, one for each tag, denominating the registration period (22.1002(c)) — see display_rules"
231
+ previous_base_reported:
232
+ note: >-
233
+ DELIBERATELY NOT MINTED AS A SERIES, per PRD-PLATES §4's rule that
234
+ Wikipedia's era tables are not sourced years. The locator reports a 2011
235
+ changeover to the Fatu Rock base and, before that, "12-YY" year-indexed
236
+ serials 1945-1951, three digits 1952-1966, and four digits from 1967. NO
237
+ PRIMARY establishes any of those boundaries: A.S.C.A. Title 22 is
238
+ format-silent and American Samoa publishes no reachable plate instrument.
239
+ Rather than mint dated ids on folklore boundaries and then alias them
240
+ (PRD-QUALITY I-5/I-6), the boundaries are recorded here and a dated series
241
+ is added when a primary lands.
242
+ reported_boundaries: ["1945-1951 12-YY (year-indexed)", "1952-1966 three digits", "1967-present four digits", "2011-present Fatu Rock base"]
243
+ evidence: locator-only
244
+ class_prefix_table_reported:
245
+ note: >-
246
+ AMERICAN SAMOA ENCODES VEHICLE CLASS AND GOVERNMENT AGENCY IN A LETTER
247
+ PREFIX ON THE SERIAL, and this is the territory's single most interesting
248
+ plate fact. It is recorded here as a REPORTED TABLE, not as a decode
249
+ table, because its only source is worldlicenseplates' American Samoa page —
250
+ an unlicensed enthusiast site — corroborated only in part by dated
251
+ photographs on plateshack of plates captioned taxi, rental, dealer and
252
+ government. It is included because a parse API that meets an American Samoa
253
+ plate reading "AC 123" and has never been told that AC means Agriculture
254
+ will guess wrong, and because publishing the table WITH its provenance
255
+ grade is more useful than withholding it. IT MUST BE VERIFIED AGAINST AN
256
+ AMERICAN SAMOA PRIMARY BEFORE ANY CONSUMER DECODES FROM IT.
257
+ evidence: secondary-single-source
258
+ reported_prefixes:
259
+ AC: Agriculture
260
+ AP: Airport Authority
261
+ C: Cargo
262
+ CC: Community College
263
+ CF: Correctional Facility
264
+ CI: Criminal Investigation
265
+ CJ: Criminal Justice
266
+ CP: Commercial Bus
267
+ CT: Commercial Truck
268
+ DM: University
269
+ DOT: Coastguard
270
+ DPS: Department of Public Safety
271
+ EC: Early Childhood Department
272
+ ED: Education Department
273
+ EPA: Environmental Protection Agency
274
+ FA: Federal Aviation Administration
275
+ FD: Fire Department
276
+ GO: Governor
277
+ GS: Government Supply
278
+ IP: Important Person
279
+ MB: Motorcycle
280
+ MC: Medical Clinic
281
+ MD: Medical Doctor
282
+ MP: Motor Pool
283
+ MS: Medical Services
284
+ MT: Manpower Training
285
+ PD: Police Department
286
+ PS: Department of Public Safety
287
+ PW: Public Works
288
+ PWD: Public Works Department
289
+ R: Rental Car
290
+ SE: Special Education
291
+ SS: Social Security Administration
292
+ ST: School Transport
293
+ T: Taxi
294
+ TA: Territorial Auditor
295
+ TT: Tow Truck
296
+ TV: Television Station
297
+ US: United States Congressman
298
+ UT: Utility Division
299
+ WM: Weights and Measures
300
+ WP: Power Authority
301
+ WR: Wrecker
302
+ internal_inconsistencies: >-
303
+ RECORDED RATHER THAN CLEANED UP, because the inconsistencies are evidence
304
+ about the source's reliability. DPS and PS are both given as Department of
305
+ Public Safety; PW and PWD are both given as Public Works; and the source
306
+ itself marks PM and VR as unknown. A table with duplicate keys for one
307
+ agency and self-declared unknowns is a collector's reconstruction, not a
308
+ register, and its confidence should be read accordingly.
309
+ motorcycle_note: >-
310
+ NOTE THE MB PREFIX. If it is real, American Samoa serialises motorcycles
311
+ with a class prefix on the same numeric space rather than with a separate
312
+ reduced-size series, which would make it unlike most US jurisdictions. No
313
+ motorcycle series is minted in this file on the strength of a single table
314
+ row (recorded gap).
315
+ region_encoding: >-
316
+ NONE. American Samoa's prefix system encodes CLASS AND AGENCY, not
317
+ geography, and no source suggests any island or district coding — which is
318
+ consistent with a territory whose fleet is concentrated on Tutuila.
319
+ sources:
320
+ - "https://asbar.org/code-annotated/22-1002-application-for-and-issuance-of-license-fees/ # 22.1002 — the whole statutory content of an American Samoa standard registration: the four preconditions, two decals placed on the tags, the fee schedule ($32.00 motor vehicle plus $12.00 per ton, $32.00 renewal, $2.00 bicycle, $10.00 titles and transfers, $9.00 late penalty), two tags on first registration or after five years' absence, $22.00 tag replacement, and the $7.00 per-fee allocation to a DPS fund for law-enforcement costs and for PRODUCTION of driver licences and vehicle registrations"
321
+ - "https://asbar.org/code-annotated/22-1003-display-of-license/ # 22.1003: front and rear display, 50-foot legibility, illumination"
322
+ - "https://asbar.org/code-annotated/22-1001-motor-vehicle-registration-and-license-required/ # 22.1001: the 'valid registration and vehicle license tags' requirement, and the statute's own vocabulary — American Samoa says TAGS, not plates"
323
+ - "https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_American_Samoa # LOCATOR ONLY (PRD-PLATES §4): the four-digit numeric serial from 1967 with range 0001-9999, the 2011 Fatu Rock base, the 'Motu O Fiafiaga' slogan, 12x6 in aluminium, the reported 1977 adoption of the 6x12 standard, and the AC (agriculture) and R (rental) prefixes"
324
+ - "http://www.worldlicenseplates.com/world/PA_AMSA.html # CORROBORATION + GAP-FINDER (PRD-PLATES §4): the full reported class/agency prefix table transcribed above as REPORTED data, the plate history from 1927, and the separate non-passenger categories (Cargo, Commercial Bus, Commercial Truck, Government Official, Government 2020 Series, Motorcycle, Public Service Vehicle, Rental Vehicle, Taxi). No licence statement on the site — treated as all rights reserved; facts only, no text or images copied"
325
+ - "http://www.plateshack.com/y2k/American_Samoa/asy2k.html # CORROBORATION: dated photographs establishing multi-year decal stacking on single tags ('August 2019 through August 21', 'January 2017 through January 2023'), which is the practical confirmation of 22.1002(f)'s five-year reissue rule; plus dated taxi, rental, dealer, government and US Congressional-delegate plates"
326
+ - "https://www.aamva.org/getmedia/646bcc8a-219b-47d8-b5cd-726240473163/License-Plate-Standard-Edition-3_September-2025-Update.pdf # AAMVA Ed.3 geometry and the 75-foot legibility recommendation against which American Samoa's statutory 50 feet is compared"
327
+ notes: >-
328
+ AMERICAN SAMOA STANDARD ISSUE. THE ID IS DELIBERATELY UNDATED and the period
329
+ is an UPPER BOUND: `start: 1972` is the enactment of PL 12-65, the act that
330
+ produced the current Chapter 10, and the four-digit numeric arrangement is
331
+ reported to predate it by five years. It is recorded as the instrument date
332
+ rather than invented. THREE THINGS MAKE THIS THE MOST DISTINCTIVE STANDARD
333
+ SERIES IN THE TERRITORIES GROUP. First, it is ALL-NUMERIC, the only one in
334
+ the group, which means an American Samoa plate carries no letters at all
335
+ unless it carries a CLASS PREFIX — so the presence of letters is itself a
336
+ classification signal. Second, TAGS ARE NOT REISSUED at every registration:
337
+ 22.1002(f)'s five-year rule means a single pair of tags can accumulate half a
338
+ decade of decals, and the photographs prove it does. Third, the statute calls
339
+ them TAGS throughout, which is preserved here rather than normalised, because
340
+ a jurisdiction's own vocabulary is a fact about it.
341
+
342
+ # =========================================================================
343
+ # CORE DISTINCT CLASSES. American Samoa demonstrably serialises these
344
+ # separately — the reported prefix table and dated photographs agree — but
345
+ # NOTHING about them is in the statute. Every one is `matching: recall-only`.
346
+ # =========================================================================
347
+ - id: us-as-government
348
+ class: government
349
+ categories: [car, van, truck, bus]
350
+ period: { start: 2026 }
351
+ period_evidence: photographic-in-use-upper-bound
352
+ matching: recall-only
353
+ format:
354
+ pattern: "LL 999"
355
+ regex: '\A[A-Z0-9](?: ?[A-Z0-9])*\z'
356
+ charset:
357
+ notes: >-
358
+ NO GRAMMAR IS SOURCED. The reported structure is an agency prefix of one
359
+ to three letters followed by a number in the ordinary numeric space —
360
+ DPS, PD, ED, GO (Governor), EPA, FD, PWD and about thirty more. The
361
+ regex is a shape catch-all and claims none of it.
362
+ pattern_note: "ILLUSTRATIVE PATTERN, CATCH-ALL REGEX. `matching: recall-only` — a match is a shape hit, never a claim that the string is a valid American Samoa government tag."
363
+ design: { plate: { note: "not sourced" }, emblem: { present: true, rendered: placeholder } }
364
+ reported_generations: "a distinct government series is reported as first issued in 2005 (with DHS and DOH among the photographed agency prefixes), and a further 'Government (2020 Series)' is listed separately — two generations within twenty years, neither dated by any instrument"
365
+ region_encoding: none
366
+ sources:
367
+ - "http://www.worldlicenseplates.com/world/PA_AMSA.html # CORROBORATION: the 'Government, Official' and 'Government (2020 Series)' categories, and the agency prefix table transcribed under us-as-standard"
368
+ - "http://www.plateshack.com/y2k/American_Samoa/asy2k.html # CORROBORATION: photographs of 'American Samoa Government vehicle plate of type first issued in 2005' with DHS and DOH prefixes read off them, 'Government Vehicle plates in recent use manufactured in 2005' with a PA prefix, and a plate for the non-voting Congressional Representative — the US prefix in the reported table"
369
+ - "https://asbar.org/code-annotated/22-1005-exemptions/ # 22.1005 'Exemptions' — the statutory hook under which a government fleet would sit; its text was not extracted in this pass (recorded gap)"
370
+ notes: >-
371
+ AMERICAN SAMOA GOVERNMENT TAGS. Minted because two independent secondary
372
+ sources agree that a distinct government series exists and photographs read
373
+ agency prefixes off actual plates — but with NOTHING taken from the statute,
374
+ because 22.1005 ("Exemptions") was not extracted and no American Samoa
375
+ instrument describes a government tag. `period: {start: 2026}` is a read-date
376
+ upper bound and carries no historical claim. THE CONGRESSIONAL-DELEGATE PLATE
377
+ is the curiosity worth preserving: American Samoa issues a distinct tag for
378
+ its non-voting Member of the US House, which is a plate class that exists in
379
+ only a handful of jurisdictions anywhere.
380
+
381
+ - id: us-as-taxi
382
+ class: taxi
383
+ categories: [car, van, bus]
384
+ period: { start: 2026 }
385
+ period_evidence: photographic-in-use-upper-bound
386
+ matching: recall-only
387
+ format:
388
+ pattern: "LL 999"
389
+ regex: '\A[A-Z0-9](?: ?[A-Z0-9])*\z'
390
+ charset: { notes: "reported prefix T for taxis; CP is reported for commercial buses and is a separate reported class. No grammar is sourced" }
391
+ pattern_note: "illustrative pattern, catch-all regex — see us-as-government's note"
392
+ design: { plate: { note: "not sourced" }, emblem: { present: true, rendered: placeholder } }
393
+ region_encoding: none
394
+ sources:
395
+ - "http://www.plateshack.com/y2k/American_Samoa/asy2k.html # CORROBORATION: dated photographs of American Samoa TAXI plates with August 2024, September 2015, August 2006 and June 2018 expirations — an eighteen-year run of a continuously distinct taxi tag"
396
+ - "http://www.worldlicenseplates.com/world/PA_AMSA.html # CORROBORATION: 'Taxi' as its own non-passenger category, and the reported T prefix"
397
+ notes: >-
398
+ AMERICAN SAMOA TAXI TAGS. THE BEST-CORROBORATED NON-STANDARD SERIES IN THIS
399
+ FILE, and still only photographic: two independent enthusiast sources, one
400
+ of them with dated photographs spanning 2006 to 2024, agree that American
401
+ Samoa issues a distinct taxi tag. That is enough to assert the SERIES EXISTS
402
+ and not nearly enough to assert its grammar, which is why the regex is a
403
+ catch-all and `matching` is recall-only.
404
+
405
+ - id: us-as-agricultural
406
+ class: agricultural
407
+ categories: [truck, trailer]
408
+ period: { start: 2026 }
409
+ period_evidence: secondary-reported-upper-bound
410
+ matching: recall-only
411
+ format:
412
+ pattern: "LL 999"
413
+ regex: '\A[A-Z0-9](?: ?[A-Z0-9])*\z'
414
+ charset: { notes: "reported prefix AC. No grammar is sourced" }
415
+ pattern_note: "illustrative pattern, catch-all regex — see us-as-government's note"
416
+ design: { plate: { note: "not sourced" }, emblem: { present: true, rendered: placeholder } }
417
+ region_encoding: none
418
+ sources:
419
+ - "https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_American_Samoa # LOCATOR: the 'AC 123' agriculture serial format, listed among American Samoa's non-passenger types"
420
+ - "http://www.worldlicenseplates.com/world/PA_AMSA.html # CORROBORATION: 'AC Agriculture' in the reported prefix table — the one prefix on which the locator and the enthusiast table independently agree, which is why this class is minted and most of the other forty are not"
421
+ notes: >-
422
+ AMERICAN SAMOA AGRICULTURE TAGS. Minted for a narrow and explicit reason:
423
+ of the forty-odd prefixes in the reported table, AC is one of only two that a
424
+ SECOND, INDEPENDENT source also reports (the other is R for rental cars,
425
+ which is not minted because _meta/classes.yml has no `rental` value — see
426
+ the file-level gap note). Two sources agreeing on one prefix is the minimum
427
+ bar this file applies before giving a reported class its own series, and
428
+ applying that bar consistently is why the other prefixes stay in the reported
429
+ table under us-as-standard rather than becoming forty thin series.
430
+
431
+ - id: us-as-dealer
432
+ class: dealer
433
+ categories: [car, van, truck]
434
+ period: { start: 2026 }
435
+ period_evidence: photographic-in-use-upper-bound
436
+ matching: recall-only
437
+ format:
438
+ pattern: "LL 999"
439
+ regex: '\A[A-Z0-9](?: ?[A-Z0-9])*\z'
440
+ charset: { notes: "no prefix is reported for dealer tags and no grammar is sourced — this series rests on a single photographed example" }
441
+ pattern_note: "illustrative pattern, catch-all regex — see us-as-government's note"
442
+ design: { plate: { note: "not sourced" }, emblem: { present: false } }
443
+ binding: business
444
+ region_encoding: none
445
+ sources:
446
+ - "http://www.plateshack.com/y2k/American_Samoa/asy2k.html # CORROBORATION ONLY: a photograph captioned 'American Samoa dealer license plate issued in 2000' — the sole evidence that a distinct dealer tag exists"
447
+ notes: >-
448
+ AMERICAN SAMOA DEALER TAGS. THE WEAKEST-EVIDENCED SERIES IN THIS FILE and
449
+ flagged as such: one photograph, one source, no prefix reported, no statute.
450
+ It is minted rather than dropped only because PRD-PLATES §7's L2 scope names
451
+ dealer as a core class to spec where the jurisdiction separately serialises
452
+ it, and a cited placeholder with `matching: recall-only` is more useful to a
453
+ consumer than silence. A verifier should treat this entry as the first thing
454
+ to either confirm or delete.