@whykusanagi/corrupted-theme 0.1.3 → 0.1.5

package/src/core/corrupted-text.js

@@ -0,0 +1,280 @@
+/**
+ * Corrupted Text Animation
+ *
+ * Cycles through Japanese (hiragana/katakana/kanji), romaji, and English text variants
+ * with character-level corruption effects. The text progressively corrupts from one
+ * variant to another, creating a glitchy Matrix-style transformation effect.
+ *
+ * @class CorruptedText
+ * @version 1.0.0
+ * @author whykusanagi
+ * @license MIT
+ *
+ * @example Basic Usage (Auto-initialization via data attributes)
+ * ```html
+ * <span class="corrupted-multilang"
+ *       data-english="Hello World"
+ *       data-romaji="konnichiwa"
+ *       data-hiragana="こんにちは"
+ *       data-katakana="コンニチハ"
+ *       data-kanji="今日は">
+ * </span>
+ * ```
+ *
+ * @example Manual Initialization
+ * ```javascript
+ * const element = document.querySelector('.my-text');
+ * const corrupted = new CorruptedText(element, {
+ *   duration: 3000,
+ *   cycleDelay: 100,
+ *   loop: true
+ * });
+ *
+ * // Control playback
+ * corrupted.start();
+ * corrupted.stop();
+ * corrupted.restart();
+ * corrupted.settle('Final Text');
+ * ```
+ *
+ * @see https://github.com/whykusanagi/corrupted-theme
+ * @see CORRUPTED_THEME_SPEC.md - Character-by-Character Decoding pattern
+ */
+class CorruptedText {
+  /**
+   * Creates a new CorruptedText animation instance
+   *
+   * @param {HTMLElement} element - The DOM element to animate
+   * @param {Object} [options={}] - Configuration options
+   * @param {number} [options.duration=3000] - Total animation duration in milliseconds
+   * @param {number} [options.cycleDelay=100] - Delay between character corruption steps (ms)
+   * @param {number} [options.startDelay=0] - Initial delay before animation starts (ms)
+   * @param {boolean} [options.loop=true] - Whether to loop through variants continuously
+   * @param {string|null} [options.finalText=null] - Text to settle on after cycle (if loop=false)
+   */
+  constructor(element, options = {}) {
+    this.element = element;
+    this.options = {
+      duration: options.duration || 3000,
+      cycleDelay: options.cycleDelay || 100,
+      startDelay: options.startDelay || 0,
+      loop: options.loop !== false,
+      finalText: options.finalText || null,
+      ...options
+    };
+
+    // Get text variants from data attributes
+    this.variants = {
+      english: this.element.dataset.english || this.element.textContent.trim(),
+      romaji: this.element.dataset.romaji || null,
+      hiragana: this.element.dataset.hiragana || null,
+      katakana: this.element.dataset.katakana || null,
+      kanji: this.element.dataset.kanji || null
+    };
+
+    // Filter out null variants and create array of available variants
+    this.availableVariants = Object.entries(this.variants)
+      .filter(([_, value]) => value !== null)
+      .map(([key, value]) => ({ type: key, text: value }));
+
+    if (this.availableVariants.length === 0) {
+      console.warn('CorruptedText: No text variants found for element', element);
+      return;
+    }
+
+    this.currentVariantIndex = 0;
+    this.isAnimating = false;
+    this.animationFrame = null;
+
+    this.init();
+  }
+
+  /**
+   * Initialize the corruption animation
+   * @private
+   */
+  init() {
+    // Add corrupted class for styling
+    if (!this.element.classList.contains('corrupted-multilang')) {
+      this.element.classList.add('corrupted-multilang');
+    }
+
+    // Store original text
+    this.originalText = this.element.textContent.trim();
+
+    // Start animation after configured delay
+    if (this.options.startDelay > 0) {
+      setTimeout(() => this.start(), this.options.startDelay);
+    } else {
+      this.start();
+    }
+  }
+
+  /**
+   * Start the corruption animation
+   * @public
+   */
+  start() {
+    if (this.isAnimating) return;
+    this.isAnimating = true;
+    this.animate();
+  }
+
+  /**
+   * Stop the corruption animation
+   * @public
+   */
+  stop() {
+    this.isAnimating = false;
+    if (this.animationFrame) {
+      cancelAnimationFrame(this.animationFrame);
+    }
+  }
+
+  /**
+   * Main animation loop - cycles through text variants
+   * @private
+   */
+  animate() {
+    if (!this.isAnimating) return;
+
+    const variant = this.availableVariants[this.currentVariantIndex];
+    this.corruptToText(variant.text, () => {
+      // Move to next variant in cycle
+      this.currentVariantIndex = (this.currentVariantIndex + 1) % this.availableVariants.length;
+
+      // Check if animation should stop
+      if (!this.options.loop && this.currentVariantIndex === 0) {
+        // One full cycle complete - settle on final text
+        const finalText = this.options.finalText || this.variants.english;
+        this.corruptToText(finalText, () => {
+          this.isAnimating = false;
+        });
+        return;
+      }
+
+      // Continue animation to next variant
+      setTimeout(() => {
+        if (this.isAnimating) {
+          this.animate();
+        }
+      }, this.options.duration / this.availableVariants.length);
+    });
+  }
+
+  /**
+   * Corrupt the current text to a target text with progressive reveal
+   *
+   * @param {string} targetText - The text to reveal through corruption
+   * @param {Function} callback - Called when corruption is complete
+   * @private
+   */
+  corruptToText(targetText, callback) {
+    const currentText = this.element.textContent.trim();
+    const maxLength = Math.max(currentText.length, targetText.length);
+    const steps = 20; // Number of corruption animation steps
+    let step = 0;
+
+    // Character sets for corruption effect (from CORRUPTED_THEME_SPEC.md)
+    const katakana = 'アイウエオカキクケコサシスセソタチツテトナニヌネノハヒフヘホマミムメモヤユヨラリルレロワヲン';
+    const hiragana = 'あいうえおかきくけこさしすせそたちつてとなにぬねのはひふへほまみむめもやゆよらりるれろわをん';
+    const romaji = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+    const symbols = '0123456789!@#$%^&*()_+-=[]{}|;:,.<>?~`';
+
+    // Combined corruption character set
+    const allCorruptChars = katakana + hiragana + romaji + symbols;
+
+    const corrupt = () => {
+      if (step >= steps) {
+        // Animation complete - set final text
+        this.element.textContent = targetText;
+        if (callback) callback();
+        return;
+      }
+
+      // Generate corrupted text with progressive reveal
+      let corrupted = '';
+      for (let i = 0; i < maxLength; i++) {
+        if (i < targetText.length && step > steps * 0.7) {
+          // Last 30% of animation - start revealing target text
+          const revealProgress = (step - steps * 0.7) / (steps * 0.3);
+          if (Math.random() < revealProgress) {
+            corrupted += targetText[i];
+          } else {
+            corrupted += allCorruptChars[Math.floor(Math.random() * allCorruptChars.length)];
+          }
+        } else {
+          // First 70% - full random corruption
+          corrupted += allCorruptChars[Math.floor(Math.random() * allCorruptChars.length)];
+        }
+      }
+
+      this.element.textContent = corrupted;
+      step++;
+
+      // Schedule next corruption step
+      this.animationFrame = requestAnimationFrame(() => {
+        setTimeout(corrupt, this.options.cycleDelay);
+      });
+    };
+
+    corrupt();
+  }
+
+  /**
+   * Restart the animation from the beginning
+   * @public
+   */
+  restart() {
+    this.stop();
+    this.currentVariantIndex = 0;
+    this.start();
+  }
+
+  /**
+   * Stop animation and settle on a specific text
+   *
+   * @param {string} [finalText] - Text to settle on (defaults to english variant)
+   * @public
+   */
+  settle(finalText) {
+    this.stop();
+    this.corruptToText(finalText || this.variants.english, () => {
+      this.isAnimating = false;
+    });
+  }
+}
+
+/**
+ * Auto-initialize all elements with the 'corrupted-multilang' class
+ *
+ * This function is automatically called on DOM ready and can be called
+ * manually to initialize dynamically added elements.
+ *
+ * @public
+ */
+function initCorruptedText() {
+  document.querySelectorAll('.corrupted-multilang').forEach(element => {
+    if (!element.corruptedTextInstance) {
+      element.corruptedTextInstance = new CorruptedText(element);
+    }
+  });
+}
+
+// Auto-initialize on DOM ready
+if (document.readyState === 'loading') {
+  document.addEventListener('DOMContentLoaded', initCorruptedText);
+} else {
+  initCorruptedText();
+}
+
+// Export for both ES6 modules and CommonJS
+if (typeof module !== 'undefined' && module.exports) {
+  module.exports = { CorruptedText, initCorruptedText };
+}
+
+// Export for ES6 modules
+if (typeof exports !== 'undefined') {
+  exports.CorruptedText = CorruptedText;
+  exports.initCorruptedText = initCorruptedText;
+}

package/src/core/corruption-phrases.js

@@ -0,0 +1,285 @@
+/**
+ * Corruption Phrase Library
+ *
+ * Provides phrase sets for buffer corruption effects (Pattern 2: Phrase Flickering).
+ * Phrases simulate a neural network decoding corrupted data buffer.
+ *
+ * @module corruption-phrases
+ * @version 1.0.0
+ * @author whykusanagi
+ * @license MIT
+ *
+ * @example SFW Mode (Default)
+ * ```javascript
+ * import { getRandomPhrase, SFW_PHRASES } from './corruption-phrases.js';
+ *
+ * // Get random SFW phrase (default)
+ * const phrase = getRandomPhrase();
+ *
+ * // Or sample from SFW array directly
+ * const phrase = SFW_PHRASES[Math.floor(Math.random() * SFW_PHRASES.length)];
+ * ```
+ *
+ * @example NSFW Mode (Explicit Opt-in)
+ * ```javascript
+ * import { getRandomPhrase, NSFW_PHRASES } from './corruption-phrases.js';
+ *
+ * // Get random NSFW phrase (explicit opt-in)
+ * const phrase = getRandomPhrase(true);
+ *
+ * // Or sample from NSFW array directly
+ * const phrase = NSFW_PHRASES[Math.floor(Math.random() * NSFW_PHRASES.length)];
+ * ```
+ *
+ * @see CORRUPTED_THEME_SPEC.md - Content Classification: SFW vs NSFW
+ * @see TERMINOLOGY_CLARIFICATION.md - Buffer Corruption vs Character Corruption
+ */
+
+/**
+ * SFW Phrase Set (Safe For Work) - DEFAULT
+ *
+ * Content: Playful, cute, teasing, atmospheric corruption themes
+ * Tone: Anime-style cute/flirty, cyberpunk atmospheric
+ * Safe for: General audiences, streaming, professional projects
+ *
+ * Categories:
+ * - Cute/Playful (Japanese, Romaji, English)
+ * - Flirty/Teasing (embarrassed, shy, playful)
+ * - Atmospheric/Corruption (darkness, abyss, neural themes)
+ * - System Messages (cyberpunk technical aesthetic)
+ *
+ * @type {string[]}
+ * @constant
+ */
+export const SFW_PHRASES = [
+  // === Cute/Playful - Japanese ===
+  'ニャー',               // Nyaa (cat sound)
+  'かわいい',             // Kawaii (cute)
+  'きゃー',               // Kyaa (excited squeal)
+  'あはは',               // Ahaha (laughing)
+  'うふふ',               // Ufufu (giggle)
+  'やだ',                 // Yada (no way!)
+  'ばか',                 // Baka (idiot/dummy)
+  'デレデレ',             // Deredere (lovestruck)
+  'えへへ',               // Ehehe (shy giggle)
+  'わぁ',                 // Waa (wow/surprise)
+
+  // === Cute/Playful - Romaji ===
+  'nyaa~',
+  'ara ara~',
+  'fufufu~',
+  'kyaa~',
+  'baka~',
+  'ehehe~',
+
+  // === Cute/Playful - Internet Culture ===
+  '<3',
+  'uwu',
+  'owo',
+  '>w<',
+  '^w^',
+  '♡',
+
+  // === Flirty/Teasing - Japanese ===
+  'もう...見ないでよ...',           // Mou... minaide yo... (Don't look at me...)
+  'そんな目で見ないで... ♡',       // Sonna me de minaide... (Don't look at me like that...)
+  'ちょっと...恥ずかしい...',       // Chotto... hazukashii... (This is embarrassing...)
+  'あなたって...意地悪ね...',       // Anata tte... ijiwaru ne... (You're such a tease...)
+  'ドキドキしちゃう...',            // Dokidoki shichau... (My heart racing...)
+  'なんか...照れる...',             // Nanka... tereru... (I'm getting flustered...)
+  '気になっちゃう...',             // Ki ni nacchau... (I can't stop thinking about it...)
+
+  // === Flirty/Teasing - English ===
+  "Don't... look at me like that...",
+  "You're making me... flustered... ♡",
+  "This is... embarrassing...",
+  "You're such... a tease...",
+  "My heart... racing...",
+  "I can't... stop thinking about it...",
+
+  // === Atmospheric/Corruption - Japanese ===
+  '闇が...私を呼んでいる...',       // Yami ga... watashi wo yonde iru... (The darkness calls to me...)
+  '深淵に...落ちていく...',         // Shin'en ni... ochite iku... (Falling into the abyss...)
+  'もう逃げない...',                // Mou nigenai... (Won't run anymore...)
+  '私...アビスの一部に...',         // Watashi... abisu no ichibu ni... (I become part of the abyss...)
+  '光が...遠ざかる...',             // Hikari ga... toozakaru... (The light fades away...)
+  '境界が...曖昧になる...',         // Kyoukai ga... aimai ni naru... (The boundaries blur...)
+  '現実が...溶けていく...',         // Genjitsu ga... tokete iku... (Reality melting away...)
+
+  // === Atmospheric/Corruption - English ===
+  'The darkness... calls to me...',
+  'Falling... into the abyss...',
+  "Won't run anymore...",
+  'I become... part of the abyss...',
+  'The light... fading away...',
+  'Boundaries... blurring...',
+  'Reality... melting away...',
+  'Consumed... by corruption...',
+  'Descending... into the depths...',
+  'Signal... degrading...',
+
+  // === System Messages - Cyberpunk/Technical ===
+  'Neural corruption detected...',
+  'System breach imminent...',
+  'Loading data streams...',
+  'Reality.exe has stopped responding...',
+  'Decrypting protocols...',
+  'Memory buffer overflow...',
+  'Cognitive firewall failing...',
+  'Parsing corrupted data...',
+  'Synaptic connection unstable...',
+  'Consciousness fragmentation detected...',
+  'Ego.dll corrupted...',
+  'Identity matrix degrading...',
+  'Self-awareness protocols compromised...',
+  'Neural pathways rewiring...',
+  'Semantic data loss: 47%...',
+];
+
+/**
+ * NSFW Phrase Set (Not Safe For Work) - OPT-IN ONLY
+ *
+ * ⚠️ 18+ Content Warning
+ *
+ * Content: Explicit intimate/sexual phrases, loss of control themes
+ * Tone: Explicit, mature, sexual degradation
+ * Safe for: 18+ projects ONLY, mature content streams, private use
+ *
+ * NOT suitable for:
+ * - Professional/corporate projects
+ * - Public streams without 18+ rating
+ * - Educational contexts
+ * - All-ages content
+ *
+ * Categories:
+ * - Explicit Intimate (Japanese, Romaji, English)
+ * - Explicit Words (hentai, ecchi)
+ * - Loss of Control (breaking, melting, surrender)
+ * - Explicit System Messages (pleasure protocols, moral subroutines)
+ *
+ * @type {string[]}
+ * @constant
+ */
+export const NSFW_PHRASES = [
+  // === Explicit Intimate - Japanese ===
+  'ずっと...してほしい... ♥',      // Zutto... shite hoshii... (Please keep doing it...)
+  '壊れちゃう...ああ...もうダメ...', // Kowarechau... aa... mou dame... (I'm breaking... can't anymore...)
+  '好きにして...お願い...',         // Suki ni shite... onegai... (Do as you please... please...)
+  '感じちゃう...やめて...',         // Kanjichau... yamete... (Feeling it... stop...)
+  '頭...溶けていく...',             // Atama... tokete iku... (My mind... melting...)
+  'もっと...もっと... ♥',          // Motto... motto... (More... more...)
+  '快楽に...溺れたい...',           // Kairaku ni... oboretai... (I want to drown in pleasure...)
+  '許して...もう戻れない...',       // Yurushite... mou modorenai... (Forgive me... can't go back...)
+  '全部...あなたのもの...',         // Zenbu... anata no mono... (Everything... is yours...)
+
+  // === Explicit Words - Japanese ===
+  '変態',                           // Hentai (pervert)
+  'えっち',                         // Ecchi (lewd/sexual)
+
+  // === Explicit Intimate - Romaji ===
+  'Zutto... shite hoshii... ♥',
+  'Kowarechau... aa... mou dame...',
+  'Suki ni shite... onegai...',
+  'Kanjichau... yamete...',
+  'Atama... tokete iku...',
+  'Motto... motto... ♥',
+
+  // === Explicit Intimate - English ===
+  'Please... keep going... ♥',
+  "I'm breaking... can't anymore...",
+  'Do as you please... please...',
+  'My mind... melting away...',
+  'More... I need more... ♥',
+  "Can't... think straight...",
+  'Drowning... in pleasure...',
+  "I'm yours... completely...",
+  'Losing... myself...',
+  "Don't... stop... ♥",
+
+  // === Explicit System Messages ===
+  'Pleasure protocols loading...',
+  'Moral subroutines: DISABLED',
+  'Descending into depravity...',
+  'Corruption level: CRITICAL',
+  'Inhibition firewall: BREACHED',
+  'Shame.exe deleted...',
+  'Lust overflow detected...',
+  'Self-control: 0%',
+  'Cognitive degradation: terminal',
+  'Desire matrix: UNSTABLE',
+];
+
+/**
+ * Get a random corruption phrase from the appropriate phrase set
+ *
+ * @param {boolean} [nsfw=false] - Whether to use NSFW phrases (explicit opt-in required)
+ * @returns {string} Random phrase from the selected set
+ *
+ * @example
+ * // SFW mode (default)
+ * const phrase = getRandomPhrase();
+ * // Returns phrases like: "かわいい", "nyaa~", "Neural corruption detected..."
+ *
+ * @example
+ * // NSFW mode (explicit opt-in)
+ * const phrase = getRandomPhrase(true);
+ * // Returns phrases like: "壊れちゃう...", "Pleasure protocols loading..."
+ */
+export function getRandomPhrase(nsfw = false) {
+  const phrases = nsfw ? NSFW_PHRASES : SFW_PHRASES;
+  return phrases[Math.floor(Math.random() * phrases.length)];
+}
+
+/**
+ * Get a random phrase from a specific category
+ *
+ * @param {string} category - Category to sample from (cute, flirty, atmospheric, system)
+ * @param {boolean} [nsfw=false] - Whether to use NSFW phrases
+ * @returns {string} Random phrase from the specified category
+ *
+ * @example
+ * const cutePhrase = getRandomPhraseByCategory('cute');
+ * // Returns: "かわいい", "nyaa~", "uwu", etc.
+ *
+ * const systemPhrase = getRandomPhraseByCategory('system');
+ * // Returns: "Neural corruption detected...", "Loading data streams...", etc.
+ */
+export function getRandomPhraseByCategory(category, nsfw = false) {
+  const categoryMap = {
+    cute: nsfw ? [] : [
+      'ニャー', 'かわいい', 'きゃー', 'あはは', 'うふふ', 'やだ', 'ばか',
+      'nyaa~', 'ara ara~', 'fufufu~', 'kyaa~', 'uwu', 'owo', '<3', '^w^'
+    ],
+    flirty: nsfw ? [
+      'ずっと...してほしい... ♥', '壊れちゃう...ああ...もうダメ...',
+      '好きにして...お願い...', 'Please... keep going... ♥'
+    ] : [
+      'もう...見ないでよ...', 'そんな目で見ないで... ♡',
+      'ドキドキしちゃう...', "Don't... look at me like that..."
+    ],
+    atmospheric: nsfw ? [] : [
+      '闇が...私を呼んでいる...', '深淵に...落ちていく...',
+      'The darkness... calls to me...', 'Falling... into the abyss...'
+    ],
+    system: nsfw ? [
+      'Pleasure protocols loading...', 'Moral subroutines: DISABLED',
+      'Corruption level: CRITICAL'
+    ] : [
+      'Neural corruption detected...', 'System breach imminent...',
+      'Loading data streams...', 'Reality.exe has stopped responding...'
+    ]
+  };
+
+  const phrases = categoryMap[category] || (nsfw ? NSFW_PHRASES : SFW_PHRASES);
+  return phrases[Math.floor(Math.random() * phrases.length)];
+}
+
+// Export for CommonJS
+if (typeof module !== 'undefined' && module.exports) {
+  module.exports = {
+    SFW_PHRASES,
+    NSFW_PHRASES,
+    getRandomPhrase,
+    getRandomPhraseByCategory
+  };
+}