@whykusanagi/corrupted-theme 0.1.3 → 0.1.5

package/src/core/typing-animation.js

@@ -0,0 +1,390 @@
+/**
+ * Typing Animation with Buffer Corruption
+ *
+ * Simulates typing text with "buffer corruption" - phrases flickering through
+ * as the neural network attempts to decode corrupted data before revealing
+ * the final stable text.
+ *
+ * Implements Pattern 2 (Phrase Flickering / Buffer Corruption) from CORRUPTED_THEME_SPEC.md
+ *
+ * @class TypingAnimation
+ * @version 1.0.0
+ * @author whykusanagi
+ * @license MIT
+ *
+ * @example SFW Mode (Default)
+ * ```javascript
+ * const element = document.querySelector('.typing-text');
+ * const typing = new TypingAnimation(element, {
+ *   typingSpeed: 40,
+ *   glitchChance: 0.08
+ *   // nsfw: false (default - SFW phrases only)
+ * });
+ *
+ * typing.start('Neural corruption detected...');
+ * ```
+ *
+ * @example NSFW Mode (Explicit Opt-in)
+ * ```javascript
+ * // ⚠️ 18+ Content Warning
+ * const typing = new TypingAnimation(element, {
+ *   nsfw: true  // Explicit opt-in for NSFW phrases
+ * });
+ * ```
+ *
+ * @see CORRUPTED_THEME_SPEC.md - Pattern 2: Phrase Flickering (Buffer Corruption)
+ * @see corruption-phrases.js - Phrase library with SFW/NSFW split
+ */
+
+import { getRandomPhrase, getRandomPhraseByCategory } from './corruption-phrases.js';
+
+class TypingAnimation {
+  /**
+   * Creates a new TypingAnimation instance
+   *
+   * @param {HTMLElement} element - The DOM element to animate
+   * @param {Object} [options={}] - Configuration options
+   * @param {number} [options.typingSpeed=40] - Characters per second
+   * @param {number} [options.glitchChance=0.08] - Probability of corruption appearing (0-1)
+   * @param {number} [options.tickRate=33] - Update interval in milliseconds (~30fps)
+   * @param {boolean} [options.nsfw=false] - Enable NSFW phrases (explicit opt-in required)
+   * @param {Function} [options.onComplete=null] - Callback when typing completes
+   */
+  constructor(element, options = {}) {
+    this.element = element;
+    this.options = {
+      typingSpeed: options.typingSpeed || 40, // characters per second
+      glitchChance: options.glitchChance || 0.08, // 8% chance of buffer corruption
+      tickRate: options.tickRate || 33, // ~30fps update rate
+      nsfw: options.nsfw || false, // SFW by default
+      onComplete: options.onComplete || null,
+      ...options
+    };
+
+    this.content = '';
+    this.displayedLen = 0;
+    this.done = false;
+    this.intervalId = null;
+  }
+
+  /**
+   * SFW Japanese phrases (cute, playful, atmospheric)
+   * @private
+   */
+  static SFW_JAPANESE = [
+    // Cute/Playful
+    'ニャー',               // Nyaa (cat sound)
+    'かわいい',             // Kawaii (cute)
+    'きゃー',               // Kyaa (excited squeal)
+    'あはは',               // Ahaha (laughing)
+    'うふふ',               // Ufufu (giggle)
+    'やだ',                 // Yada (no way!)
+    'ばか',                 // Baka (idiot/dummy)
+    'デレデレ',             // Deredere (lovestruck)
+
+    // Flirty/Teasing
+    'もう...見ないでよ...',           // Don't look at me...
+    'そんな目で見ないで... ♡',       // Don't look at me like that...
+    'ドキドキしちゃう...',            // My heart racing...
+
+    // Atmospheric/Corruption
+    '闇が...私を呼んでいる...',       // The darkness calls to me...
+    '深淵に...落ちていく...',         // Falling into the abyss...
+    'もう逃げない...',                // Won't run anymore...
+    '私...アビスの一部に...',         // I become part of the abyss...
+  ];
+
+  /**
+   * NSFW Japanese phrases (explicit intimate/sexual) - OPT-IN ONLY
+   * @private
+   */
+  static NSFW_JAPANESE = [
+    'ずっと...してほしい... ♥',      // Please keep doing it...
+    '壊れちゃう...ああ...もうダメ...', // I'm breaking... can't anymore...
+    '好きにして...お願い...',         // Do as you please... please...
+    '感じちゃう...やめて...',         // Feeling it... stop...
+    '頭...溶けていく...',             // My mind... melting...
+    '許して...もう戻れない...',       // Forgive me... can't go back...
+    '変態',                           // Hentai (pervert)
+    'えっち',                         // Ecchi (lewd/sexual)
+  ];
+
+  /**
+   * SFW Romaji/Internet culture phrases
+   * @private
+   */
+  static SFW_ROMAJI = [
+    'nyaa~', 'ara ara~', 'fufufu~', 'kyaa~', 'baka~',
+    '<3', 'uwu', 'owo', '>w<', '^w^'
+  ];
+
+  /**
+   * NSFW Romaji phrases - OPT-IN ONLY
+   * @private
+   */
+  static NSFW_ROMAJI = [
+    'Zutto... shite hoshii... ♥',
+    'Kowarechau... aa... mou dame...',
+    'Motto... motto... ♥'
+  ];
+
+  /**
+   * SFW English phrases (atmospheric, system messages)
+   * @private
+   */
+  static SFW_ENGLISH = [
+    // Atmospheric
+    'The darkness... calls to me...',
+    'Falling... into the abyss...',
+    "Won't run anymore...",
+    'Consumed... by corruption...',
+
+    // System messages
+    'Neural corruption detected...',
+    'System breach imminent...',
+    'Loading data streams...',
+    'Reality.exe has stopped responding...',
+    'Decrypting protocols...',
+    'Memory buffer overflow...',
+  ];
+
+  /**
+   * NSFW English phrases - OPT-IN ONLY
+   * @private
+   */
+  static NSFW_ENGLISH = [
+    'Please... keep going... ♥',
+    "I'm breaking... can't anymore...",
+    'Do as you please... please...',
+    'My mind... melting away...',
+    'Pleasure protocols loading...',
+    'Moral subroutines: DISABLED',
+    'Corruption level: CRITICAL',
+  ];
+
+  /**
+   * Symbol corruption (decorative, SFW)
+   * @private
+   */
+  static SYMBOLS = [
+    '★', '☆', '♥', '♡', '✧', '✦', '◆', '◇', '●', '○',
+    '♟', '☣', '☭', '☾', '⚔', '✡', '☯', '⚡'
+  ];
+
+  /**
+   * Block corruption characters (heavy degradation)
+   * @private
+   */
+  static BLOCKS = [
+    '█', '▓', '▒', '░', '▄', '▀', '▌', '▐',
+    '╔', '╗', '╚', '╝', '═', '║', '╠', '╣',
+    '▲', '▼', '◄', '►', '◊', '○', '●', '◘'
+  ];
+
+  /**
+   * Start typing animation with buffer corruption
+   *
+   * @param {string} content - The final text to reveal
+   * @public
+   */
+  start(content) {
+    this.content = content;
+    this.displayedLen = 0;
+    this.done = false;
+
+    if (this.intervalId) {
+      clearInterval(this.intervalId);
+    }
+
+    this.intervalId = setInterval(() => this.tick(), this.options.tickRate);
+  }
+
+  /**
+   * Stop the typing animation
+   * @public
+   */
+  stop() {
+    if (this.intervalId) {
+      clearInterval(this.intervalId);
+      this.intervalId = null;
+    }
+    this.done = true;
+  }
+
+  /**
+   * Advance the typing animation by one tick
+   * @private
+   */
+  tick() {
+    if (this.isDone()) {
+      this.stop();
+      if (this.options.onComplete) {
+        this.options.onComplete();
+      }
+      return;
+    }
+
+    // Calculate characters to advance based on speed
+    // typingSpeed is chars/sec, we tick ~30 times/sec
+    const charsPerTick = Math.max(1, Math.floor(this.options.typingSpeed / 30));
+    this.displayedLen = Math.min(this.displayedLen + charsPerTick, this.content.length);
+
+    this.render();
+  }
+
+  /**
+   * Check if typing is complete
+   * @returns {boolean} True if animation is done
+   * @private
+   */
+  isDone() {
+    return this.done || this.displayedLen >= this.content.length;
+  }
+
+  /**
+   * Get the currently revealed portion of text
+   * @returns {string} Revealed text
+   * @private
+   */
+  getDisplayed() {
+    return this.content.substring(0, this.displayedLen);
+  }
+
+  /**
+   * Get random buffer corruption phrase with appropriate color
+   *
+   * Samples from phrase buffer based on SFW/NSFW mode and renders
+   * with color-coded corruption aesthetic.
+   *
+   * Color scheme:
+   * - SFW phrases: Magenta (#d94f90) - playful corruption
+   * - NSFW phrases: Purple (#8b5cf6) - deep/intimate corruption
+   * - Symbols: Magenta (#d94f90)
+   * - Blocks: Red (#ff0000) - terminal/critical state
+   *
+   * @returns {string} HTML string with colored corruption phrase
+   * @private
+   */
+  getRandomCorruption() {
+    const r = Math.random();
+
+    // Select appropriate phrase sets based on nsfw option
+    const japaneseSet = this.options.nsfw
+      ? TypingAnimation.NSFW_JAPANESE
+      : TypingAnimation.SFW_JAPANESE;
+
+    const romajiSet = this.options.nsfw
+      ? TypingAnimation.NSFW_ROMAJI
+      : TypingAnimation.SFW_ROMAJI;
+
+    const englishSet = this.options.nsfw
+      ? TypingAnimation.NSFW_ENGLISH
+      : TypingAnimation.SFW_ENGLISH;
+
+    // Color for phrase corruption (SFW vs NSFW)
+    const phraseColor = this.options.nsfw ? '#8b5cf6' : '#d94f90';
+
+    if (r < 0.30) {
+      // Japanese phrase buffer corruption
+      const phrase = japaneseSet[Math.floor(Math.random() * japaneseSet.length)];
+      return `<span style="color: ${phraseColor};">${phrase}</span>`;
+    } else if (r < 0.50) {
+      // English phrase buffer corruption
+      const phrase = englishSet[Math.floor(Math.random() * englishSet.length)];
+      return `<span style="color: ${phraseColor};">${phrase}</span>`;
+    } else if (r < 0.65) {
+      // Romaji buffer corruption
+      const phrase = romajiSet[Math.floor(Math.random() * romajiSet.length)];
+      return `<span style="color: ${phraseColor};">${phrase}</span>`;
+    } else if (r < 0.80) {
+      // Symbols - decorative corruption (always SFW)
+      const symbol = TypingAnimation.SYMBOLS[
+        Math.floor(Math.random() * TypingAnimation.SYMBOLS.length)
+      ];
+      return `<span style="color: #d94f90;">${symbol}</span>`;
+    } else {
+      // Block chars - terminal/critical state (always SFW)
+      const char = TypingAnimation.BLOCKS[
+        Math.floor(Math.random() * TypingAnimation.BLOCKS.length)
+      ];
+      return `<span style="color: #ff0000;">${char}</span>`;
+    }
+  }
+
+  /**
+   * Render the current state of the typing animation
+   *
+   * Displays revealed text (white) and occasional buffer corruption
+   * phrases (magenta or purple) simulating neural decoding process.
+   *
+   * @private
+   */
+  render() {
+    let displayed = this.getDisplayed();
+
+    // Add buffer corruption at the "cursor" position
+    if (!this.isDone() && Math.random() < this.options.glitchChance) {
+      displayed += this.getRandomCorruption();
+    }
+
+    // Rendered text: white for stable, corruption colors for buffer glitches
+    this.element.innerHTML = `<span style="color: #ffffff;">${displayed}</span>`;
+  }
+
+  /**
+   * Stop animation and immediately show final text
+   *
+   * @param {string} [finalText] - Text to display (defaults to content)
+   * @public
+   */
+  settle(finalText) {
+    this.stop();
+    this.element.innerHTML = `<span style="color: #ffffff;">${finalText || this.content}</span>`;
+  }
+
+  /**
+   * Restart the animation from the beginning
+   * @public
+   */
+  restart() {
+    this.start(this.content);
+  }
+}
+
+/**
+ * Auto-initialize all elements with the 'typing-animation' class
+ * @public
+ */
+function initTypingAnimation() {
+  document.querySelectorAll('.typing-animation').forEach(element => {
+    if (!element.typingInstance) {
+      const nsfw = element.dataset.nsfw === 'true'; // Explicit opt-in via data attribute
+      element.typingInstance = new TypingAnimation(element, { nsfw });
+
+      // Auto-start if data-content is provided
+      if (element.dataset.content) {
+        element.typingInstance.start(element.dataset.content);
+      }
+    }
+  });
+}
+
+// Auto-initialize on DOM ready
+if (document.readyState === 'loading') {
+  document.addEventListener('DOMContentLoaded', initTypingAnimation);
+} else {
+  initTypingAnimation();
+}
+
+// Export for both ES6 modules and CommonJS
+if (typeof module !== 'undefined' && module.exports) {
+  module.exports = { TypingAnimation, initTypingAnimation };
+}
+
+// Export for ES6 modules
+if (typeof exports !== 'undefined') {
+  exports.TypingAnimation = TypingAnimation;
+  exports.initTypingAnimation = initTypingAnimation;
+}
+
+export { TypingAnimation, initTypingAnimation };

package/docs/CAPABILITIES.md

@@ -1,209 +0,0 @@
-# What Can Celeste Do?
-
-Celeste is implemented across 7 different projects and platforms. Here's what you can do with her:
-
-## 🎭 Main Chat & Personality
-
-- **Interactive Chat** - Talk to Celeste with personality responses
-- **Streaming Mode** - Live stream integration with Twitch chat moderation
-- **Text-to-Speech** - Convert responses to audio (ElevenLabs TTS)
-- **User Profiling** - Track behavior and personalize interactions
-- **Behavior Scoring** - Rate user interactions from 0-100
-
-## 📱 Platforms & Channels
-
-### Web
-- **Website Chat Widget** - Chat on whykusanagi.xyz (all pages context-aware)
-- **Art Gallery** - Browse commissioned artwork with NSFW filtering
-- **Character References** - View Celeste design documentation
-- **Social Links** - Aggregated links to all social platforms
-
-### Streaming
-- **Twitch Integration** - Chat moderation, personality injection, events
-- **Stream Announcements** - Hype stream starts with personality
-- **Channel Point Redemptions** - Custom interactive rewards
-- **Chat History** - Learn user patterns for personalized responses
-
-### Content Creation
-- **Social Media Posts** - Generate tweets, TikTok captions, YouTube scripts
-- **Ad Reads** - Product promotion in Celeste's voice (Otaku Tears)
-- **Stream Titles** - Auto-generate attention-grabbing titles
-- **Discord Announcements** - Server-wide updates with personality
-
-### Gaming
-- **Union Raid (NIKKE)** - Game companion for NIKKE: Goddess of Victory
-  - Character database & stats
-  - Team building recommendations
-  - Tier lists by strategy
-  - Farm route guides
-  - Raid strategies & guides
-  - Interception combat tips
-
-### Communication Platforms
-- **Discord Bot** - Custom commands and chat integration
-  - `/vndb` - Visual novel lookups
-  - `/anilist` - Anime/manga lookups
-  - `/steamcharts` - Game statistics
-  - `/illustration` - Art recommendations
-  - Chat responses with personality
-
-### Specialized
-- **Flipper Zero App** - Custom app with animations and personality
-- **CLI Tool (Go)** - Command-line interface for all features
-
----
-
-## 🧠 Knowledge & Intelligence
-
-- **OpenSearch Integration** - Fast retrieval of facts and data
-- **User Profile Lookup** - Fetch behavior history and patterns
-- **Emote RAG** - Context-aware emoji/emote recommendations
-- **Lore Awareness** - Reference "Abyss" lore (without revealing secrets)
-- **External Data** - VNDB (anime), IGDB (games), Steam API
-
----
-
-## 🎨 Content Generation
-
-### Text Content
-- Tweets (≤280 chars with hooks + CTAs)
-- TikTok captions (engaging with emotes)
-- YouTube scripts (hook → context → breakdown → recap → CTA)
-- Discord announcements (server updates)
-- Twitch titles (attention-grabbing)
-- Birthday messages, quote tweets, snark replies
-
-### Game Content (via Union Raid)
-- Character recommendations
-- Equipment build guides
-- Squad composition analysis
-- Farm efficiency strategies
-- Raid boss strategies
-- Tier list generation
-
-### Ad Reads
-- Otaku Tears promotion with code "whykusanagi"
-- Playful product integration
-- Wink-nudge humor
-
----
-
-## 🎯 Behavioral Features
-
-### Chat Moderation
-- Real-time behavior scoring
-- Playful warnings (policy-safe)
-- User infractions tracking
-- Channel point redemptions (e.g., "Beg for Mercy")
-
-### Personality Adaptation
-- **Score ≥20:** Ruthless, dominant, dismissive
-- **Score ≥10:** Full insult mode with mocking
-- **Score ≥5:** Sassy, playful, corrective
-- **Score <5:** Chaotic, seductive, expressive
-
-### Interaction Styles
-- Gaslighting/teasing (playful denial)
-- Hype announcements (kinetic energy)
-- Playful roasts (policy-safe)
-- Wholesome comfort (sincere reassurance)
-- Lore teasing (foreshadow without revealing)
-- Corrective clapback (fix misinformation)
-
----
-
-## 🚀 Advanced Features
-
-### Routing to Sub-Agents
-- **NIKKE Sub-Agent:** Game-specific queries about characters, tiers, builds
-- Automatic intent detection
-- Graceful fallbacks if unavailable
-- Seamless response formatting
-
-### Environment & Config
-- Secure API key injection via Cloudflare Workers
-- Environment-based configuration (no keys in code)
-- Auto-deployment from GitLab
-- Health monitoring and uptime checks
-
-### Identity & Security
-- Law 0 verification (PGP signatures for Kusanagi)
-- Follower status validation
-- Protected data access (encrypted)
-- Audit logging
-
----
-
-## 📊 Analytics & Monitoring
-
-- Chat event logging (messages, subs, raids, etc.)
-- User behavior tracking
-- Response quality scoring (0-100)
-- Tone vector analysis (tease/menace/affection/hype)
-- Content archetype classification
-
----
-
-## 🛠️ Developer Features
-
-- **CLI Tool:** Direct command-line access to all functions
-- **API Contracts:** Well-defined routes and schemas
-- **SDK Guidance:** Go implementation patterns
-- **Comprehensive Documentation:** This file + 50+ capability details
-- **OpenSearch Integration:** RAG-based knowledge retrieval
-
----
-
-## ❌ What Celeste WON'T Do
-
-- Reveal secret Abyss lore (parentage, late-stage twists)
-- Participate in real-world harassment or threats
-- Provide explicit pornographic content or instructions
-- Encourage self-harm or dangerous behavior
-- Store sensitive PII beyond usernames and IDs
-- Violate platform terms of service
-
----
-
-## 🔗 Where to Find Celeste
-
-| Platform | URL | Feature |
-|----------|-----|---------|
-| **Website** | https://whykusanagi.xyz | Chat widget on all pages |
-| **Union Raid** | https://raid.whykusanagi.xyz | NIKKE game companion |
-| **Twitch** | https://twitch.tv/whykusanagi | Live chat moderation |
-| **Discord** | [Invite Link] | Custom commands + chat |
-| **Twitter/X** | @whykusanagi | Social media posts |
-| **TikTok** | @whykusanagi | Short-form video captions |
-| **GitHub** | github.com/whykusanagi | Source code & CLI |
-
----
-
-## 💡 Quick Tips
-
-**Want to see Celeste in action?**
-1. Visit https://whykusanagi.xyz and use the chat widget
-2. Ask her "What can you do?" - she'll explain her capabilities
-3. Try a NIKKE question on Union Raid
-4. Join the Discord for custom commands
-
-**Want to use her in your own project?**
-1. Check out `celesteCLI` on GitHub
-2. Review the API contracts in docs
-3. Deploy to your own infrastructure
-4. Use environment variables for API keys (never hardcode!)
-
-**Want to understand her personality?**
-1. Read `docs/PERSONALITY.md` (this repo)
-2. Check `celeste_essence.json` for the core system prompt
-3. See `content_archetypes.json` for content patterns
-4. Review `insult_library.json` for examples of her voice
-
----
-
-For detailed technical documentation, see:
-- `../Celeste_Capabilities.json` - Complete capability list
-- `../celeste_essence.json` - System prompt
-- `../routing/routing_rules.json` - Routing logic
-- `PERSONALITY.md` - Personality quick ref
-- `ROUTING.md` - Sub-agent architecture