Text chat 4: fluxer-emoji crate #254

Closed
opened 2026-11-12 11:07:35 +00:00 by charles · 0 comments
Owner

Plan: docs/superpowers/plans/2026-11-12-textchat.md, section "Task 4". Spec: docs/superpowers/specs/2026-11-12-fluxer-native-textchat-design.md.

Task 4: fluxer-emoji crate

Issue: #TBD

Files:

  • Create: crates/fluxer-emoji/{Cargo.toml,README.md}, src/{lib.rs,data.rs,search.rs,twemoji.rs,frecency.rs,jumbo.rs,emoticons.rs}, crates/fluxer-emoji/data/emojis.json (copied from app/media/data/emojis.json with an attribution header in the README)
  • Modify: workspace Cargo.toml (member)
  • Test: crates/fluxer-emoji/tests/{data.rs,search.rs,twemoji.rs,frecency.rs}

Interfaces:

  • Produces: Category::{People, Nature, Food, Activity, Travel, Objects, Symbols, Flags} with label() and icon_name() (spec §3.4 table); Emoji { names: &[String], surrogates: &str, keywords, category, diversity: Option<[&str; 5]> }; dataset() -> &'static Dataset (lazy, OnceLock); Dataset::{by_name(&str), by_surrogate(&str), in_category(Category), all(), shortcuts() -> &[(text, name)]}; SkinTone::{Default, Light, MediumLight, Medium, MediumDark, Dark} and Emoji::with_skin(SkinTone) -> Cow<str>; search(query, limit) -> Vec<&Emoji> (ranking as feat/expressions/utils/UnicodeEmojis.ts / Emoji.search: exact name, prefix, keyword, contains); twemoji_codepoints(surrogates) -> String (FE0F stripped unless ZWJ, EmojiCodepointUtils.ts); twemoji_url(static_cdn, surrogates) -> String ({static_cdn}/emoji/{cp}.svg?v=2); Frecency { record(key, now_ms), score(key, now_ms), top(n, now_ms) } with score = log2(count+1) · 0.5^(age/7d), 200 keys, ties by last used, count, key (feat/emoji/state/UsageFrecency.ts), loadable from and dumpable to BTreeMap<String, (u32 count, i64 last_used_ms)>; emoticon_at(text) -> Option<(&str name, usize len)>; is_jumbo(nodes_summary: impl Iterator<Item = JumboToken>) -> bool (≤30 emoji, only whitespace text).

  • Step 1: Write failing tests: every_surrogate_maps_back_to_its_first_name, categories_in_original_order, skin_tone_variants, search_ranks_exact_then_prefix_then_keyword (cases from the fork's tests where they exist), twemoji_codepoints_cases (❤️, 👨‍👩‍👧, 🏳️‍🌈, 👍🏽, 🇫🇷, ©️), frecency_matches_formula_and_tie_breaks, frecency_keeps_200_keys, emoticons_match_original_list, jumbo_rule_30_and_text, dataset_loads_fast (release, < 50 ms; #[ignore] in debug).

  • Step 2–5: FAIL → implement → PASS → commit feat(emoji): Unicode emoji dataset, search, Twemoji and frecency.

🤖 Generated with Claude Code

Plan: `docs/superpowers/plans/2026-11-12-textchat.md`, section "Task 4". Spec: `docs/superpowers/specs/2026-11-12-fluxer-native-textchat-design.md`. ### Task 4: `fluxer-emoji` crate **Issue:** #TBD **Files:** - Create: `crates/fluxer-emoji/{Cargo.toml,README.md}`, `src/{lib.rs,data.rs,search.rs,twemoji.rs,frecency.rs,jumbo.rs,emoticons.rs}`, `crates/fluxer-emoji/data/emojis.json` (copied from `app/media/data/emojis.json` with an attribution header in the README) - Modify: workspace `Cargo.toml` (member) - Test: `crates/fluxer-emoji/tests/{data.rs,search.rs,twemoji.rs,frecency.rs}` **Interfaces:** - Produces: `Category::{People, Nature, Food, Activity, Travel, Objects, Symbols, Flags}` with `label()` and `icon_name()` (spec §3.4 table); `Emoji { names: &[String], surrogates: &str, keywords, category, diversity: Option<[&str; 5]> }`; `dataset() -> &'static Dataset` (lazy, `OnceLock`); `Dataset::{by_name(&str), by_surrogate(&str), in_category(Category), all(), shortcuts() -> &[(text, name)]}`; `SkinTone::{Default, Light, MediumLight, Medium, MediumDark, Dark}` and `Emoji::with_skin(SkinTone) -> Cow<str>`; `search(query, limit) -> Vec<&Emoji>` (ranking as `feat/expressions/utils/UnicodeEmojis.ts` / `Emoji.search`: exact name, prefix, keyword, contains); `twemoji_codepoints(surrogates) -> String` (FE0F stripped unless ZWJ, `EmojiCodepointUtils.ts`); `twemoji_url(static_cdn, surrogates) -> String` (`{static_cdn}/emoji/{cp}.svg?v=2`); `Frecency { record(key, now_ms), score(key, now_ms), top(n, now_ms) }` with `score = log2(count+1) · 0.5^(age/7d)`, 200 keys, ties by last used, count, key (`feat/emoji/state/UsageFrecency.ts`), loadable from and dumpable to `BTreeMap<String, (u32 count, i64 last_used_ms)>`; `emoticon_at(text) -> Option<(&str name, usize len)>`; `is_jumbo(nodes_summary: impl Iterator<Item = JumboToken>) -> bool` (≤30 emoji, only whitespace text). - [ ] **Step 1: Write failing tests**: `every_surrogate_maps_back_to_its_first_name`, `categories_in_original_order`, `skin_tone_variants`, `search_ranks_exact_then_prefix_then_keyword` (cases from the fork's tests where they exist), `twemoji_codepoints_cases` (❤️, 👨‍👩‍👧, 🏳️‍🌈, 👍🏽, 🇫🇷, ©️), `frecency_matches_formula_and_tie_breaks`, `frecency_keeps_200_keys`, `emoticons_match_original_list`, `jumbo_rule_30_and_text`, `dataset_loads_fast` (release, < 50 ms; `#[ignore]` in debug). - [ ] **Step 2–5:** FAIL → implement → PASS → commit `feat(emoji): Unicode emoji dataset, search, Twemoji and frecency`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
charles added this to the Text chat milestone 2026-11-12 11:07:35 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
charles/fluxer-native#254
No description provided.