Release 0.3.0: emoji support

New charguana.emoji module bundles parsed Unicode emoji data (latest):
- emoji_chars: 1,219-item frozenset of Emoji_Presentation codepoints
- emoji_sequences: 2,339 keycap/flag/modifier sequences
- emoji_zwj_sequences: 1,614 ZWJ compositions (family, skintone, etc.)
- emoji_properties: char -> frozenset of UCD emoji properties
- is_emoji(s): True for a known single emoji or multi-char sequence
- fetch_emoji(version='latest'): runtime fetch from unicode.org as an
  escape hatch (stdlib urllib, no requests dep)

All bundled data is lazy-loaded via PEP 562 __getattr__; importing
charguana.emoji is free. get_charset('emoji') now works.

Maintainer tooling:
- scripts/refresh_emoji.py regenerates data/emoji/*.txt from unicode.org
- scripts/generate_perluniprops.sh moved from repo root for consistency

Package sizes:
- 1,219 emoji chars, 2,339 sequences, 1,614 ZWJ, 3,679 properties rows
- Wheel grows 197 KB -> 222 KB (+13%)

Tests: 32 passing on 3.10-3.14 (up from 27).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: alvations

README.md

@@ -13,6 +13,22 @@ Install
 pip install charguana
 ```
 
+### What's new in 0.3.0
+
+- **Emoji support.** New `charguana.emoji` module bundles parsed Unicode
+  emoji data (latest version).
+  - `get_charset('emoji')` returns the list of single-codepoint
+    Emoji_Presentation characters.
+  - `is_emoji(s)` — True for a single emoji char or a known multi-char
+    sequence (flags, ZWJ combos, keycaps, modifier sequences).
+  - `charguana.emoji.emoji_sequences`, `emoji_zwj_sequences`,
+    `emoji_properties` for finer access. All lazy-loaded.
+  - `fetch_emoji(version='latest')` hits unicode.org for fresh data at
+    runtime (requires network; no side effects on disk).
+- Maintainer tooling: `scripts/refresh_emoji.py` regenerates the bundled
+  emoji data files from unicode.org. Alongside the existing
+  `scripts/generate_perluniprops.sh`.
+
 ### What's new in 0.2.0
 
 - `get_charset(name)` now returns a **list** instead of a generator. Use
@@ -133,6 +149,36 @@ True
 '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmn'
 ```
 
+**Emoji**
+
+```python
+>>> from charguana import get_charset, is_emoji
+>>> get_charset('emoji')[:5]
+['⌚', '⌛', '⏩', '⏪', '⏫']
+>>> is_emoji('😀')
+True
+>>> is_emoji('🇺🇸')        # regional-indicator sequence (US flag)
+True
+>>> is_emoji('👨\u200d👩\u200d👧\u200d👦')   # ZWJ: family
+True
+>>> is_emoji('A')
+False
+
+# Finer access to sequences and properties (lazy-loaded):
+>>> from charguana.emoji import emoji_sequences, emoji_zwj_sequences, emoji_properties
+>>> '🇺🇸' in emoji_sequences
+True
+>>> emoji_properties['😀']
+frozenset({'Emoji', 'Emoji_Presentation'})
+
+# Runtime fetch from unicode.org (needs network):
+>>> from charguana import fetch_emoji
+>>> parsed = fetch_emoji()   # or fetch_emoji('16.0')
+>>> sorted(parsed.keys())
+['data_properties', 'sequences', 'variation_sequences', 'zwj_sequences']
+```
+
+
 **Thai**
 
 ```python

charguana/__init__.py

@@ -6,6 +6,7 @@
 from charguana.perluniprops import *
 from charguana.thai import *
 from charguana.viet import *
+from charguana.emoji import is_emoji, fetch_emoji
 
 cjk_charsets = {'chinese': han_utf8, 'zh': han_utf8, 'cn': han_utf8,
                 'japanese': jap_utf8, 'ja': jap_utf8, 'jp': jap_utf8,
@@ -104,13 +105,18 @@ def get_charset_ranges(charset_ranges):
 # (either an explicit list, a long string, or an expanded range). The Thai
 # block is stored as (start, end) tuples in ``thai_utf8`` for reference; we
 # expand it once here so the dict is shape-consistent with the others.
+#
+# ``'emoji'`` is lazy-resolved: the underlying frozenset is loaded on first
+# access via ``charguana.emoji`` (see ``iter_charset`` below).
 other_charsets = {
     'thai': list(get_charset_ranges(thai_utf8)),
     'viet': viet_utf8,
     'traditional_chinese': big5,
     'simplified_chinese': gbk,
 }
 
+_lazy_other_charsets = {'emoji'}
+
 
 def iter_charset(charset_name):
     """Return a lazy iterator over the characters in the named charset.
@@ -120,7 +126,7 @@ def iter_charset(charset_name):
 
     Valid names: any key of ``cjk_charsets``, ``perluniprops_charsets``, or
     ``other_charsets`` — e.g. 'chinese', 'japanese', 'korean', 'thai', 'viet',
-    'traditional_chinese', 'simplified_chinese', 'IsAlpha', 'IsN',
+    'traditional_chinese', 'simplified_chinese', 'emoji', 'IsAlpha', 'IsN',
     'Open_Punctuation', 'Currency_Symbol', etc. Unknown names yield nothing.
     """
     if charset_name in cjk_charsets:
@@ -129,6 +135,9 @@ def iter_charset(charset_name):
         return iter(perluniprops_charsets[charset_name])
     if charset_name in other_charsets:
         return iter(other_charsets[charset_name])
+    if charset_name in _lazy_other_charsets:
+        from charguana import emoji as _emoji
+        return iter(sorted(getattr(_emoji, f'{charset_name}_chars')))
     return iter(())
 
 
@@ -179,6 +188,8 @@ def all_in_charset(string, charset):
     'thai_utf8', 'thai_block',
     # Vietnamese
     'viet_utf8', 'viet_tones', 'viet_consonants', 'viet_ime',
+    # Emoji
+    'is_emoji', 'fetch_emoji',
     # perluniprops
     'open_punctuation', 'close_punctuation', 'currency_symbol',
     'is_sc', 'is_alnum', 'is_alpha', 'is_lower', 'is_upper', 'is_n', 'is_so',