usernames 0.1.3

data/data/LICENSES/petname.txt

@@ -0,0 +1,218 @@
+petname (usr/share/petname/{small,medium}/*.txt) — https://github.com/dustinkirkland/petname
+
+Copyright: 2014-2023, Dustin Kirkland <dustin.kirkland@gmail.com>   (from upstream debian/copyright)
+
+Licensed under the Apache License, Version 2.0 (the full text follows).
+
+Apache-2.0 section 4 notices for this redistribution:
+  (a) this file is the copy of the License that accompanies the work;
+  (b) MODIFIED FILES: data/words/adjectives.txt and data/words/animals.txt are derived from
+      petname's word lists and were changed by the usernames project: intersected with or merged
+      into other lists, filtered for length, offensive substrings and a manual review, and
+      re-sorted (script/build_words_data.rb; details in data/NOTICE);
+  (c) upstream copyright notices are retained above;
+  (d) petname ships no NOTICE file, so there are no NOTICE contents to reproduce.
+------------------------------------------------------------------------------
+
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/data/LICENSES/rfc2142.txt

@@ -0,0 +1,9 @@
+RFC 2142, "Mailbox Names for Common Services, Roles and Functions" (D. Crocker, May 1997)
+https://www.rfc-editor.org/rfc/rfc2142.txt
+------------------------------------------------------------------------------
+
+Only the 15 mailbox names the RFC specifies are used (abuse ftp hostmaster info marketing news
+noc postmaster sales security support usenet uucp webmaster www). They are standards facts, not
+copyrightable expression; no RFC text is reproduced. The RFC's own status notice reads:
+"Distribution of this memo is unlimited." (RFC 2142 predates the IETF Trust Legal Provisions and
+carries no other licence statement.)

data/data/LICENSES/shouldbee.txt

@@ -0,0 +1,25 @@
+shouldbee/reserved-usernames — https://github.com/shouldbee/reserved-usernames
+(The upstream copyright line names a year and no holder; it is reproduced exactly.)
+------------------------------------------------------------------------------
+
+The MIT License (MIT)
+
+Copyright (c) 2014 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/data/LICENSES/usernames.txt

@@ -0,0 +1,30 @@
+usernames — this gem's own curation (https://github.com/rameerez/usernames)
+
+Covers: the hand-typed reserved-word facts (impersonation roles; code sentinels; mention words;
+Windows device names and accounts; Debian/systemd users; Rails, Hotwire and engine routes — each
+retyped from public facts, see the block comments; no GPL/AGPL file was copied), the es offensive
+tiers, data/offensive/hate.yml and leet.yml, the Wikipedia-verified names in the en allowlist
+(names as facts), the es allowlist, and the selection/curation of every list.
+------------------------------------------------------------------------------
+
+The MIT License (MIT)
+
+Copyright (c) 2026 Javi R
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/data/NOTICE

@@ -0,0 +1,36 @@
+usernames — bundled data notices
+================================
+
+Every word list under data/ is built from the sources below by the scripts in script/
+(build_reserved_data.rb, build_offensive_data.rb, build_words_data.rb). Each source's full
+licence text and copyright line is in data/LICENSES/<name>.txt. Revisions are the HEAD commit
+of each upstream repository on the retrieval date, 2026-10-27 (the date the source files were
+downloaded); the last commit touching the file used is given too
+where it differs. Nothing GPL, AGPL, CC-BY, CC-BY-NC or unlicensed is vendored: words from such
+sources (Mastodon, Discourse, Misskey, Debian base-passwd, Microsoft Learn) appear only as short
+retyped facts under the `usernames` row.
+
+One row per source:
+Columns: name | URL | pinned revision | licence | what was taken | transformation
+
+big-username-blocklist | https://github.com/marteinn/The-Big-Username-Blocklist | c5d456f6af0285931c85e08d53ed7e1ac35d31fc (list_raw.txt: 1776a3b6385aae1677bd7e5d9ee47790ed19cf25, 2021-02-13) | MIT, (c) 2015-2021 Martin Sandström | list_raw.txt (541 words) | lowercased; dropped HTTP status codes, entries of 1-2 characters, first names/surnames and words already in another category → data/reserved/web.txt
+shouldbee | https://github.com/shouldbee/reserved-usernames | 0302214e8c1363fc5877ce3343ef6262e8852e96 (reserved-usernames.txt: 60e53759220f229e246023571d10b19676efe64b, 2020-03-19) | MIT, (c) 2014 (no holder named upstream) | reserved-usernames.txt (603 words) | as above, plus company/product names (facebook, github, twitter, java, python, ...), the typo `iamges` and first names (nick, mac, page, price, win, old, list, ping) removed → web.txt
+mottie-github-reserved-names | https://github.com/Mottie/github-reserved-names | 1a017f43777cc5c2ed2992a3d81862fbe325c21b (reserved-names.json: 2b6c209853207ee0ac015486fe1cb1a18d11f848, 2026-05-28) | MIT, (c) Rob Garrison | reserved-names.json (302 entries) | HTTP codes, GitHub-only pages (hovercards, codespaces, copilot, gist, ...) and product names removed → web.txt
+gitlab | https://gitlab.com/gitlab-org/gitlab | 47dedfb0a40c303092dc16d44f728c67b5c6512e (lib/gitlab/path_regex.rb, 2026-10-23) | MIT Expat (content outside ee/ and doc/), (c) 2011-present GitLab Inc. | TOP_LEVEL_ROUTES + PROJECT_WILDCARD_ROUTES (59) | entries containing `/` and 1-character entries dropped → web.txt
+gitea | https://github.com/go-gitea/gitea | f35c67bd79b3bff9c28eb8171d53586cc800bd5c (models/user/user.go: 1d8474ee1feb2ae744beb6d240eb6212469c71ee, 2026-10-24) | MIT, (c) 2016 The Gitea Authors, (c) 2015 The Gogs Authors | reservedUsernames in models/user/user.go (30) | `.`/`..` and `gitea-actions` dropped → web.txt (ghost → system.txt)
+django-registration | https://github.com/ubernostrum/django-registration | ee9458a46403c46e7ea4440876f774a715bef047 (src/django_registration/validators.py: 9033b918052d322e199ebeb25d472118999fb23e, 2024-11-09) | BSD-3-Clause, (c) James Bennett and contributors | DEFAULT_RESERVED_NAMES (102) with its group rationale | split by group: special hostnames → system.txt; CA addresses, protocol hostnames, no-reply → mailboxes.txt; filenames and account paths → web.txt
+forwardemail | https://github.com/forwardemail/reserved-email-addresses-list | d9e7397b4fa1476c5b76b2523281af4ed3281c07 (index.json: 2931ae92f72ac07bdbe39600183ba1347cf4bdda, 2025-06-30) | MIT, (c) 2020 Nick Baugh | ASCII base names of index.json, admin-list.json, no-reply-list.json (140) | the ~3,000 leet/homoglyph variants (acc0unt, bi1ling) dropped — folding is the matcher's job; role mailboxes → mailboxes.txt, generic words → web.txt
+rfc2142 | https://www.rfc-editor.org/rfc/rfc2142.txt | RFC 2142 (May 1997, Standards Track) | IETF standards facts; "Distribution of this memo is unlimited" | the 15 mailbox names | none → mailboxes.txt
+iana-well-known-uris | https://www.iana.org/assignments/well-known-uris/well-known-uris-1.csv | registry as retrieved 2026-10-27 (116 rows) | CC0-1.0 (IANA/IETF joint statement, 2021-11-10) | URI suffixes, permanent + provisional (102) | organisation/product names (ashrae, gs1resolver, terraform.json, amphtml, knx) dropped → web.txt
+dsojevic-profanity-list | https://github.com/dsojevic/profanity-list | c27924319aa9bd6f917e3782b4f4b6604a50b652 (en.json, 2021-10-23) | MIT, (c) 2021 David Sojevic | en.json (434 entries: match patterns, severity, tags, exceptions) | re-tiered and reviewed 2026-10-27 (kike faggot chink paki coon gook wetback tranny chingchong neonazi → 4; jap wog → 3; spic stays 3; pansy cissy hermie santorum finocchio shota → 2); `negro`, `enby`, `cishet` removed; `rapist` split from `raping`; rape/raping/rapist segment_only; `*` expanded to 0-3 extra repeats; spaces/hyphens removed; emoji dropped; exceptions expanded with the term; dictionary exceptions added for promoted slurs → data/offensive/en.json; exceptions also → allowlist/en.txt
+obscenity | https://github.com/jo3-l/obscenity | 32c9061c1ad18de43432e4e59084189628f2a2a4 (src/preset/english.ts: 0c752986aef1caaf30a3c2cfc4ebdc27f8b894a3, 2026-01-18) | MIT, (c) 2025 Joseph Liu | the 66 whitelisted terms of the English preset | kept only real words/names of >= 5 letters (fragments such as `an al`, `s hit`, `assem` dropped) → allowlist/en.txt
+cuss | https://github.com/words/cuss | 6bab3fef250481e34ba55bc400fac5c6d25f1429 (es.js: d14479ad4ab7b42e63e1634e16c68c71cd8d9dbb, 2022-11-07) | MIT, (c) 2016 Titus Wormer | Spanish words (es.js, 650 rated) as attestation | hand-tiered severe/strong/mild with AllProfanity and a hand-reviewed list of severe candidates; ASCII-folded (ñ→n, accents stripped) → data/offensive/es.json (reviewed 2026-10-27; see data/offensive/README.md)
+allprofanity | https://github.com/ayush-jadaun/AllProfanity | 96cda24c878310d9ad1ca9d8e40c109a931addac (src/languages/spanish-words.ts: 2df915c8c7cc6a348876da178486e875db4ecb77, 2025-04-26) | MIT, (c) 2025 Ayush Jadaun | Spanish words (216) as attestation | as cuss → es.json
+friendly-words | https://github.com/glitchdotcom/friendly-words | f94b4639c71c26875f7684fa86a214c7f30deaad (words/predicates.txt: 524e8865110aebe2b4675e231b9cf87c3bbeda69, 2025-03-13) | MIT, (c) 2018 Glitch | words/predicates.txt (1,450) | intersected with petname adjectives; watch-list and reviewed words removed; offensive-substring filter → data/words/adjectives.txt
+petname | https://github.com/dustinkirkland/petname | d263497a655beed5577f9592d766702194a4f2df (retrieved 2026-10-27) | Apache-2.0, (c) 2014-2023 Dustin Kirkland; no upstream NOTICE file | usr/share/petname/{small,medium}/adjectives.txt, small/names.txt | MODIFIED (Apache-2.0 §4(b)): intersected/merged with other lists, filtered (3-10 letters, offensive substrings, manual review), re-sorted → data/words/adjectives.txt, animals.txt
+imsky-wordlists | https://github.com/imsky/wordlists | 6520a7c6cf9de8fed31c3acc197517836d663baf (retrieved 2026-10-27) | MIT, (c) 2017-2021 Ivan Malopinsky | nouns/{birds,fish,cats,dogs,monkeys,snakes,apex_predators}.txt | merged, filtered and reviewed → data/words/animals.txt
+corpora | https://github.com/dariusk/corpora | 2e7adec11a0561696c236ae1fca82e88be173d42 (data/animals/common.json: 7cb3d18b49e2117f327c2fcd5504e072b4149e4c, 2022-12-31) | CC0-1.0, Darius Kazemi | data/animals/common.json (134) | multi-word entries dropped; merged, filtered and reviewed → data/words/animals.txt
+usernames | https://github.com/rameerez/usernames | this repository | MIT, (c) 2026 Javi R | own curation: hand-typed reserved facts (Mastodon/Discourse/Misskey defaults, Slack/Mattermost mention words, Windows device names and accounts from Microsoft Learn, Debian base-passwd and systemd users, Rails/Hotwire/Devise/engine routes from their MIT sources, RFC 2606/6761 names), es tiers, hate.yml (meanings from the ADL, the Simon Wiesenthal Center and Wikipedia; nothing copied), leet.yml, Wikipedia-verified names in allowlist/en.txt (names as facts), allowlist/es.txt (Spanish words found in the FrequencyWords frequency list, as facts) | retyped, not copied; reasons in each block comment
+
+Measurement corpora under test/corpora/ (US Census 2010 surnames, /usr/share/dict) are not part
+of the gem and are documented in their own headers.

data/data/offensive/README.md

@@ -0,0 +1,90 @@
+# Offensive-word data
+
+Built by `script/build_offensive_data.rb` (en, es, allowlists); `hate.yml` and `leet.yml` are
+hand-written. Sources, revisions and licences: `data/NOTICE` and `data/LICENSES/`.
+
+## Review status
+
+Both languages ship reviewed, as of 2026-10-27:
+
+- **en** — dsojevic/profanity-list's tiers, reviewed by the maintainers: slurs promoted to severe,
+  racial abuse moved out of the disabled-by-default tiers, identity words removed and real names
+  demoted to mild (see "en" below). Every decision is a line of `script/build_offensive_data.rb`.
+- **es** — built from permissive sources and reviewed by a Spanish-speaking reviewer: `concha`,
+  `coger`, `huevos`, `semen`, `cipote` and `panchito` removed at every tier, `pija` demoted to mild.
+
+`negro` is never blocked, in any locale, by decision: it is the Spanish word for black and a common
+surname. Corrections and new languages are welcome; please include a source.
+
+## `<locale>.json`
+
+```json
+{"term": "cunt", "severity": 4, "variants": ["cunnt", "cunts", "kunt", "..."],
+ "tags": ["general"], "exceptions": ["scunthorpe", "eduskunta", "..."]}
+```
+
+| severity | tier | matched as |
+|---|---|---|
+| 4 | severe | substring of a segment (terms of 4+ letters), and across separators; `"segment_only": true` → the segment must equal the term |
+| 3 | strong | the segment equals the term (default mode `:strong` and stricter) |
+| 1–2 | mild | the segment equals the term, only in `:mild` mode |
+
+- `variants` are compact ASCII spellings (spaces, hyphens and dots removed) including stretched
+  letters (dsojevic's `*`, up to 3 extra repeats). **Leet-folded spellings are not stored**: the
+  matcher folds terms, variants, exceptions and allowlist entries with `leet.yml` at load time,
+  exactly as it folds the input.
+- `exceptions` are term-scoped segment exemptions; `allowlist/<locale>.txt` exempts a segment
+  from every term of that locale. Neither applies to a match that spans a separator.
+- No term or variant is ever `negro`, in any locale; the build aborts if one appears.
+
+## en — dsojevic/profanity-list, reviewed
+
+430 terms: 41 severe, 316 strong, 73 mild.
+
+- **Severe** = dsojevic's severity-4 entries, plus the promoted slurs `kike faggot/fagot chink paki
+  coon gook wetback tranny`, plus `chingchong` and `neonazi` (dsojevic: 2). `spic` stays strong:
+  it is inside allspice, aspic and suspicious.
+- **Strong** = dsojevic's severity 3, plus `jap` and `wog` (dsojevic: 1). Three letters, so they
+  are matched only as a whole segment: `japan`, `japanese` and `wogan` pass.
+- **Mild** (off by default) = dsojevic's severity 1–2, plus words that are also real names or
+  ordinary words: `pansy` and `cissy` (given names), `hermie` (a nickname), `santorum` and
+  `finocchio` (surnames; finocchio is also Italian for fennel), and `shota` (Shōta, a common
+  Japanese given name).
+- **Removed**: `enby` and `cishet`, identity terms people use for themselves, not slurs; and
+  `negro` (see above).
+- `rape`, `rapist` (split out of dsojevic's `raping`) and `raping` are `segment_only`: as
+  substrings they would reject grape, therapist and scraping.
+- Dictionary words a promoted slur would otherwise reject were added as exceptions of that term
+  (cocoon, snigger, pakistani, chinkapin, eduskunta, esophagotomy, …); see `EXTRA_EXCEPTIONS`.
+
+## es — wooorm/cuss and AllProfanity, tiered by hand, reviewed
+
+97 terms: 19 severe, 35 strong, 43 mild. Every term is attested in wooorm/cuss (es), AllProfanity
+(spanish) or a hand-reviewed list of severe candidates; plural and gender forms of an attested word are
+added as variants.
+
+- **Severe (slurs only):** maricon, maricona, marikon, mariconazo, marica\*, puto\*, joto,
+  bujarron, machorra, marimacho, tortillera, bollera, travelo\*, sudaca, negrata, mongolico,
+  mongolo\*, sidoso, chinorris. `*` = `segment_only`, because each is inside an innocent word
+  (puto ⊂ computo/caputo, marica ⊂ tamaricaceae, travelo ⊂ travelogue, mongolo ⊂ mongoloid).
+- **Strong:** vulgar and insulting words that are rarely anything else (mierda, joder, puta,
+  cono, culo, polla, verga, gilipollas, cabron, pendejo, chingar, …). The words inside innocent
+  ones (`puta` ⊂ computadora, `culo` ⊂ ridiculo, `cono` ⊂ economia) are never severe, never
+  substrings.
+- **Mild:** everyday insults and words with an innocent primary meaning (idiota, imbecil,
+  capullo, paja, pito, zorra, retrasado, pinche, …).
+- `subnormal` is strong although it is also an English word; `retrasado` is mild because it also
+  means "delayed"; `gabacho` is strong and `pinche` mild.
+- **Left out on purpose:** `concha` (a common female name, Concepción, and a seashell), `coger`
+  (the everyday verb "to take" in Spain), `huevos` ("eggs"), `semen` (a Ukrainian first name),
+  `cipote` ("kid" in Central America), `panchito` (a nickname for Francisco), `moronegro`
+  (unattested, and contains `negro`), `moro` (a surname), `gringo`, and the hundreds of cuss
+  entries whose ordinary meaning dominates (alcornoque, leche, palo, pistola, cuchara, …).
+
+## Allowlists
+
+`allowlist/en.txt` (obscenity's whitelist, dsojevic's exceptions, and
+Wikipedia-verified names) and `allowlist/es.txt` keep only real words and names of 5+ letters.
+Rejected at build time: fragments (`an al`, `s hit`, `assem`, `nigg`), multi-word entries whose
+join is not a word (`scunthorpe united` would otherwise exempt `scunthorpeunited`), unverified
+rows, and any entry that is itself a term of the locale (`faggot`, `penis`, `whore`).