@whykusanagi/corrupted-theme 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -14,6 +14,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.1.9] - 2026-04-19
+
+### Changed
+- **Deduplicate `CorruptedText`** - `src/core/corrupted-text.js` was an orphaned, better-documented copy of `src/lib/corrupted-text.js` (not exported by `package.json`, but still shipped). Promoted the documented version into `src/lib/corrupted-text.js` and removed the duplicate. Fixes #7.
+- **TypingAnimation buffer redesign** - `src/core/typing-animation.js` now shows a continuous, always-on buffer phrase to the right of the revealed text (flickering every 100ms on an independent timer) instead of the previous probabilistic 8%-per-tick flash. Added `duration`, `loop`, `loopDelay`, `bufferEnabled`, and `bufferFlickerSpeed` options. Default `typingSpeed` lowered from 40 → 12 chars/sec for readability in no-network demo contexts. `glitchChance` deprecated as a no-op (emits a one-time `console.warn` with migration note). All existing method signatures (`start`, `stop`, `restart`, `settle`) unchanged; new public `destroy()` added for full teardown. Refs #9.
+- **Consolidated NSFW examples** - `examples/advanced/nsfw-corruption.html` removed; its scope is now a checkbox toggle at the top of `examples/basic/typing-animation.html` (resets per page-load, no localStorage — explicit per-visit opt-in per the corrupted-theme content-rating policy).
+- **Updated example pages** - `examples/basic/typing-animation.html` migrated to the new TypingAnimation API (dropped `glitchChance`, added `loop: true, loopDelay: 2000` so demos auto-restart). Removed the now-nonfunctional "Corruption" slider.
+
+### Added
+- **CI workflow** (`.github/workflows/checks.yml`) - First automated checks for the repo: `npm run build`, `node --check` on every JS file, `dist/theme.min.css` validation, `package.json` `exports` resolution check.
+
+### Removed
+- `src/core/corrupted-text.js` (duplicate file; behavior preserved at `src/lib/corrupted-text.js`)
+- `src/css/theme.css` `.container` rule - The unused hero-grid layout (display: grid, 1fr 1fr, min-height: 100vh) that collided with every example page's single-column layout. No page in the repo used the hero behavior; removing the rule fixes 8 previously-broken example pages with zero regression. Closes #9.
+- `examples/advanced/nsfw-corruption.html` - Consolidated into the toggle on `examples/basic/typing-animation.html` (see Changed above).
+- `docs/ROADMAP.md`, `docs/FUTURE_WORK.md` - Orphaned CelesteCLI documents that referenced Go packages, AWS Bedrock, Vertex AI, etc. — entirely irrelevant to this CSS+JS theme package. Also dropped `docs/ROADMAP.md` from `package.json` `files` so future publishes won't ship it.
+
+### Deprecated
+- **`TypingAnimation` option `glitchChance`** - Ignored with a one-time `console.warn`. Behavior is now governed by `bufferEnabled: true` (default). Pass `bufferEnabled: false` for a clean typewriter with no buffer.
+
+### Documentation
+- `README.md`: updated script tag to point at `src/lib/corrupted-text.js`; removed `nsfw-corruption.html` from the file-tree listing; cross-reference now points at the typing-animation toggle.
+- `examples/basic/corrupted-text.html`: updated script tag and inline reference.
+- `CLAUDE.md` "Current Version" updated from stale 0.1.4 → 0.1.9.
+- `docs/governance/VERSION_REFERENCES.md` "One-Command Version Bump" template restructured as forward-looking (NEW=0.1.10 OLD=0.1.9) so future sed runs leave the template intact.
+
+---
+
 ## [0.1.7] - 2026-02-07
 
 ### Security

package/README.md

@@ -96,16 +96,27 @@ Copy `src/css` into your project (or use `dist/theme.min.css`) and import it loc
 │   │   └── event-tracker.js       # lifecycle: tracked addEventListener
 │   └── lib/
 │       ├── carousel.js            # carousel/slideshow with autoplay + swipe
+│       ├── celeste-proxy.js       # Celeste CLI proxy integration
+│       ├── celeste-widget.js      # Celeste chat widget
 │       ├── character-corruption.js# auto-corruption for individual characters
 │       ├── components.js          # modal, dropdown, tabs, collapse, accordion, toast
+│       ├── corrupted-particles.js # Canvas 2D floating phrase particle background
 │       ├── corrupted-text.js      # multi-language glitch animation
+│       ├── corrupted-vortex.js    # WebGL raymarched spiral vortex shader
 │       ├── corruption-loading.js  # cinematic loading curtain
 │       ├── countdown-widget.js    # event countdown with shapes
 │       └── gallery.js             # gallery grid with filtering + lightbox
 ├── dist/theme.min.css              # postcss + cssnano build output
 ├── examples/
 │   ├── showcase-complete.html      # full design system demo
-│   └── interactive-components.html # modal, dropdown, tabs, carousel demo
+│   ├── interactive-components.html # modal, dropdown, tabs, carousel demo
+│   ├── basic/
+│   │   ├── corrupted-text.html     # CorruptedText demo
+│   │   ├── multi-gallery.html      # multi-instance gallery demo
+│   │   └── typing-animation.html   # TypingAnimation demo
+│   └── advanced/
+│       ├── glsl-vortex.html        # CorruptedVortex WebGL demo
+│       └── particles-bg.html       # CorruptedParticles demo
 ├── scripts/static-server.js        # ESM static server (Docker)
 └── docs/COMPONENTS_REFERENCE.md    # exhaustive snippets
 ```
@@ -414,7 +425,7 @@ document.addEventListener('click', e => {
       data-kanji="今日は">
 </span>
 
-<script type="module" src="@whykusanagi/corrupted-theme/src/core/corrupted-text.js"></script>
+<script type="module" src="@whykusanagi/corrupted-theme/src/lib/corrupted-text.js"></script>
 ```
 
 **Pattern 2: Phrase Flickering (Buffer Corruption)**
@@ -439,11 +450,11 @@ typing.start('Neural corruption detected... System Online');
 - **SFW Mode (Default)**: Cute, playful, atmospheric phrases - safe for all audiences
 - **NSFW Mode (Opt-in)**: Explicit 18+ content - requires `{ nsfw: true }` flag
 
-See `examples/basic/` for SFW examples and `examples/advanced/nsfw-corruption.html` for NSFW demo.
+See `examples/basic/typing-animation.html` — it has a toggle switch at the top to opt into NSFW phrases (checkbox resets each page load per the explicit-opt-in spec).
 
 ## Interactive Components
 
-v0.1.7 adds JS-driven interactive components that self-initialize via `data-ct-*` attributes. Import the components module and everything wires up automatically on `DOMContentLoaded`.
+v0.1.8 adds JS-driven interactive components that self-initialize via `data-ct-*` attributes. Import the components module and everything wires up automatically on `DOMContentLoaded`.
 
 ```html
 <script type="module">
@@ -553,11 +564,35 @@ Class | Behavior
 
 ### JavaScript Corruption Components
 
+All JS corruption components follow the same lifecycle: `new Class(element, options)` with `start()`, `stop()`, `destroy()` methods. Full API details are in [COMPONENTS_REFERENCE.md](docs/COMPONENTS_REFERENCE.md#javascript-corruption-components).
+
 **CorruptedText** - Pattern 1: Character-Level Corruption
 - Visual glitch effect using random characters (Katakana, Hiragana, symbols)
 - Always SFW (no phrases, just character-level noise)
 - Cycles through multi-language variants
 - Class: `.corrupted-multilang`
+- Demo: `examples/basic/corrupted-text.html`
+
+```js
+import { initCorruptedText } from '@whykusanagi/corrupted-theme/corrupted-text';
+
+// Auto-init all .corrupted-multilang elements
+initCorruptedText();
+
+// Or manual:
+const ct = new CorruptedText(element, {
+  duration: 3000,    // total animation duration (ms)
+  cycleDelay: 100,   // delay between corruption steps (ms)
+  startDelay: 0,     // initial delay before animation
+  loop: true,        // loop or settle on final text
+  finalText: null    // text to settle on (null = english variant)
+});
+ct.start();          // begin animation
+ct.stop();           // pause
+ct.restart();        // reset to first variant
+ct.settle('Hello');  // stop and settle to specific text
+ct.destroy();        // full teardown
+```
 
 **TypingAnimation** - Pattern 2: Phrase Flickering (Buffer Corruption)
 - Simulates neural network decoding corrupted data buffer
@@ -565,6 +600,107 @@ Class | Behavior
 - SFW mode (default): Cute, playful, atmospheric phrases
 - NSFW mode (opt-in): Explicit 18+ content with `{ nsfw: true }`
 - Color: Magenta (#d94f90) for SFW, Purple (#8b5cf6) for NSFW
+- Demo: `examples/basic/typing-animation.html`
+
+```js
+import { TypingAnimation } from '@whykusanagi/corrupted-theme/src/core/typing-animation.js';
+
+const typing = new TypingAnimation(element, {
+  typingSpeed: 50,     // ms per character
+  glitchChance: 0.3,   // probability of glitch per character
+  nsfw: false          // enable 18+ phrase mode
+});
+typing.start();
+typing.stop();
+typing.settle();       // resolve to final text
+```
+
+**CorruptedParticles** - Canvas 2D Floating Phrase Background
+- Floating Japanese phrase particles across three depth layers
+- Mouse hover repel, click burst (6 particles), connection lines between nearby particles
+- SFW/NSFW phrase modes with `includeLewd` toggle
+- Demo: `examples/advanced/particles-bg.html`
+
+```js
+import CorruptedParticles from '@whykusanagi/corrupted-theme/corrupted-particles';
+
+const particles = new CorruptedParticles(canvas, {
+  count: 60,           // number of particles
+  speed: 1.0,          // global speed multiplier
+  lineDistance: 150,    // max distance for connection lines (px)
+  includeLewd: false   // enable 18+ phrases (default: off)
+});
+// auto-starts on construction
+particles.stop();      // pause animation
+particles.start();     // resume
+particles.destroy();   // full teardown
+```
+
+**CorruptedVortex** - WebGL Raymarched Spiral Vortex
+- WebGL1 raymarched black hole accretion disk shader
+- Quasar mode (hue: null) cycles yellow-to-magenta by depth
+- Fixed hue mode locks to a single color
+- Throttled to ~30fps for GPU efficiency
+- Demo: `examples/advanced/glsl-vortex.html`
+
+```js
+import CorruptedVortex from '@whykusanagi/corrupted-theme/corrupted-vortex';
+
+const vortex = new CorruptedVortex(canvas, {
+  speed: 1.0,          // animation speed multiplier
+  intensity: 1.0,      // brightness/glow intensity
+  rotationRate: 1.0,   // rotation speed of spiral
+  hue: null            // null = quasar multi-color, 0-1 = fixed hue
+});
+// auto-starts on construction
+vortex.stop();
+vortex.start();
+vortex.destroy();
+```
+
+**Character Corruption** - Auto-Corruption for Individual Characters
+- Replaces English characters with Japanese (Katakana, Hiragana, Kanji)
+- Configurable intensity levels from `NONE` (0) to `MAX_READABLE` (0.45)
+- Auto-corruption via `.auto-corrupt` class with `data-text`, `data-intensity`, `data-interval` attributes
+- Includes phrase libraries (technical UI + personality/demon phrases)
+
+```js
+import {
+  corruptTextJapanese,
+  initAutoCorruption,
+  stopAutoCorruption,
+  destroyAllAutoCorruption,
+  createCorruptedElement,
+  getRandomPhrase,
+  INTENSITY
+} from '@whykusanagi/corrupted-theme/character-corruption';
+
+// Corrupt a string at medium intensity
+corruptTextJapanese('Hello World', INTENSITY.MEDIUM); // → "Heアロo ワoケld"
+
+// Auto-init all .auto-corrupt elements on page
+initAutoCorruption();
+
+// Create a new auto-corrupting element
+const el = createCorruptedElement('System Online', {
+  intensity: 0.35,
+  interval: 2000,
+  className: 'status-text',
+  tag: 'span'
+});
+
+// Get a random phrase from the library
+getRandomPhrase('loading');              // → "initializing neural link..."
+getRandomPhrase('personality', 'japanese'); // → "データ破損検出..."
+
+// Cleanup
+stopAutoCorruption(element);    // stop one element
+destroyAllAutoCorruption();     // stop all
+```
+
+**Corruption Loading Screen** - Cinematic Loading Curtain
+- Full-screen dramatic loading animation
+- Module: `src/lib/corruption-loading.js`
 
 **Corruption Phrases Library**
 - Normalized SFW/NSFW phrase sets

package/docs/COMPONENTS_REFERENCE.md

@@ -25,6 +25,8 @@ This document provides a comprehensive reference for all components available in
     - [NSFW Content Blur](#nsfw-content-blur)
     - [Social Links List](#social-links-list)
     - [Countdown Widget](#countdown-widget)
+11. [JavaScript Corruption Components](#javascript-corruption-components)
+    - [CorruptedText](#corruptedtext) | [CorruptedParticles](#corruptedparticles) | [CorruptedVortex](#corruptedvortex) | [Character Corruption](#character-corruption) | [Corruption Loading Screen](#corruption-loading-screen)
 
 ---
 
@@ -1039,6 +1041,207 @@ initCountdown();
 
 ---
 
+## JavaScript Corruption Components
+
+Full API reference for all JavaScript corruption modules. All canvas-based components (CorruptedParticles, CorruptedVortex) auto-start on construction and use `ResizeObserver` + `IntersectionObserver` for responsive sizing and visibility-based lifecycle.
+
+### CorruptedText
+
+Multi-language glitch animation that cycles through character variants with corruption effects.
+
+**Source:** `src/lib/corrupted-text.js`
+**Demo:** `examples/basic/corrupted-text.html`
+**Import:** `@whykusanagi/corrupted-theme/corrupted-text`
+
+```js
+const ct = new CorruptedText(element, options);
+```
+
+**Constructor Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `duration` | number | `3000` | Total animation duration (ms) |
+| `cycleDelay` | number | `100` | Delay between character corruption steps (ms) |
+| `startDelay` | number | `0` | Initial delay before animation starts (ms) |
+| `loop` | boolean | `true` | Loop animation or settle on final text |
+| `finalText` | string\|null | `null` | Text to settle on when not looping (null = english variant) |
+
+**Data Attributes** (read from element):
+
+| Attribute | Description |
+|-----------|-------------|
+| `data-english` | English text (defaults to `element.textContent`) |
+| `data-romaji` | Romaji (romanized Japanese) |
+| `data-hiragana` | Hiragana text |
+| `data-katakana` | Katakana text |
+| `data-kanji` | Kanji text |
+
+**Methods:**
+
+| Method | Description |
+|--------|-------------|
+| `start()` | Begin animation (no-op if already running) |
+| `stop()` | Pause animation and clear all timers |
+| `animate()` | Cycle to next text variant with corruption effect |
+| `corruptToText(targetText, callback)` | Corrupt display to target text over 20 steps |
+| `restart()` | Reset to first variant and restart animation |
+| `settle(finalText)` | Stop and settle to final text with corruption transition |
+| `destroy()` | Cleanup and remove element reference |
+
+**Auto-Initialization:**
+
+```js
+import { initCorruptedText } from '@whykusanagi/corrupted-theme/corrupted-text';
+initCorruptedText(); // inits all .corrupted-multilang elements
+```
+
+Also auto-called on `DOMContentLoaded`.
+
+---
+
+### CorruptedParticles
+
+Canvas 2D floating Japanese phrase background with three depth layers, mouse interaction, and connection lines.
+
+**Source:** `src/lib/corrupted-particles.js`
+**Demo:** `examples/advanced/particles-bg.html`
+**Import:** `@whykusanagi/corrupted-theme/corrupted-particles`
+
+```js
+const particles = new CorruptedParticles(canvas, options);
+```
+
+**Constructor Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `count` | number | `60` | Number of particles to render |
+| `speed` | number | `1.0` | Global speed multiplier for particle movement |
+| `lineDistance` | number | `150` | Max distance between particles for connection lines (px) |
+| `includeLewd` | boolean | `false` | Enable 18+ phrase mode (logs console warning) |
+
+**Methods:**
+
+| Method | Description |
+|--------|-------------|
+| `init()` | Initialize animation system, event listeners, observers (called automatically) |
+| `start()` | Begin animation loop via `requestAnimationFrame` |
+| `stop()` | Pause animation (preserves state) |
+| `destroy()` | Full teardown: remove listeners, clear particles, disconnect observers |
+
+**Properties:**
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `canvas` | HTMLCanvasElement | Reference to canvas element |
+| `ctx` | CanvasRenderingContext2D | Canvas rendering context |
+| `particles` | Array | Currently active particle objects |
+| `mouse` | Object | `{x, y}` cursor position (updated on mousemove) |
+
+**Behaviors:**
+- Hover: particles repel from cursor
+- Click: burst of 6 particles at click location
+- Three depth layers with different speeds and opacity
+- Auto-starts/stops based on viewport intersection
+- Adjusts particle count for mobile viewports
+
+---
+
+### CorruptedVortex
+
+WebGL1 raymarched black hole accretion disk shader with corona and depth-driven color cycling.
+
+**Source:** `src/lib/corrupted-vortex.js`
+**Demo:** `examples/advanced/glsl-vortex.html`
+**Import:** `@whykusanagi/corrupted-theme/corrupted-vortex`
+
+```js
+const vortex = new CorruptedVortex(canvas, options);
+```
+
+**Constructor Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `speed` | number | `1.0` | Animation speed multiplier |
+| `intensity` | number | `1.0` | Brightness/glow intensity multiplier |
+| `rotationRate` | number | `1.0` | Rotation speed of vortex spiral |
+| `hue` | number\|null | `null` | `null` = quasar mode (depth-driven yellow→magenta), `0-1` = fixed hue |
+
+**Methods:**
+
+| Method | Description |
+|--------|-------------|
+| `init()` | Initialize WebGL context, compile shaders, set up buffer (called automatically) |
+| `start()` | Begin render loop (throttled to ~30fps) |
+| `stop()` | Pause rendering |
+| `destroy()` | Delete GL program/buffer, disconnect observers |
+
+**Properties:**
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `canvas` | HTMLCanvasElement | Reference to canvas element |
+| `gl` | WebGLRenderingContext\|null | WebGL context (null if unsupported) |
+| `program` | WebGLProgram | Compiled shader program |
+| `options` | Object | Configuration (can be modified at runtime) |
+
+**Notes:**
+- Renders at half-resolution for GPU efficiency
+- DPR capped at 2.0
+- Falls back gracefully if WebGL unavailable
+
+---
+
+### Character Corruption
+
+Auto-corruption module for replacing English characters with Japanese characters at configurable intensity levels.
+
+**Source:** `src/lib/character-corruption.js`
+**Import:** `@whykusanagi/corrupted-theme/character-corruption`
+
+**Intensity Constants:**
+
+| Constant | Value | Use Case |
+|----------|-------|----------|
+| `INTENSITY.NONE` | `0.0` | No corruption |
+| `INTENSITY.MINIMAL` | `0.15` | Subtle effect |
+| `INTENSITY.LOW` | `0.25` | Section headers |
+| `INTENSITY.MEDIUM` | `0.35` | Dashboards (recommended) |
+| `INTENSITY.HIGH` | `0.45` | Maximum readable |
+| `INTENSITY.MAX_READABLE` | `0.45` | Alias for HIGH |
+
+**Functions:**
+
+| Function | Description |
+|----------|-------------|
+| `corruptTextJapanese(text, intensity?)` | Replace English chars with Japanese (50% Katakana, 25% Kanji, 15% Keep+Insert, 10% Hiragana). Default intensity: `0.3` |
+| `corruptTextSemantic(text, context?, intensity?)` | Context-aware corruption (currently falls back to `corruptTextJapanese`) |
+| `initAutoCorruption()` | Init all `.auto-corrupt` elements. Reads `data-text`, `data-intensity`, `data-interval`. Auto-called on `DOMContentLoaded` |
+| `stopAutoCorruption(element)` | Stop re-corruption interval for a specific element |
+| `restartAutoCorruption(element)` | Stop and restart corruption cycle for element |
+| `destroyAllAutoCorruption()` | Stop all active corruption intervals |
+| `createCorruptedElement(text, options?)` | Create new element with auto-corruption. Options: `intensity`, `interval`, `className`, `tag` |
+| `getRandomPhrase(category, subcategory?)` | Random phrase from library. Categories: `loading`, `processing`, `analyzing`, `corrupting`, `watching`, `void`. Personality subcategories: `english`, `japanese`, `romaji` |
+
+**Exported Objects:**
+
+| Object | Description |
+|--------|-------------|
+| `CORRUPTION_PHRASES` | Technical UI phrases grouped by category |
+| `PERSONALITY_PHRASES` | Personality/demon phrases in English, Japanese, Romaji |
+
+---
+
+### Corruption Loading Screen
+
+Full-screen cinematic loading curtain with dramatic corruption animation.
+
+**Source:** `src/lib/corruption-loading.js`
+
+---
+
 ## Related Documentation
 
 - [README.md](../README.md) - Main documentation and quick start guide
@@ -1047,7 +1250,7 @@ initCountdown();
 
 ---
 
-**Last Updated:** 2026-02-07
-**Version:** 2.0
+**Last Updated:** 2026-04-05
+**Version:** 2.1
 **Status:** Complete and Production Ready
 

package/docs/governance/VERSION_MANAGEMENT.md

@@ -104,7 +104,7 @@ Increment when you make **backward-compatible bug fixes**:
 - **Public API**: Not stable yet
 - **Use case**: Early adopters, experimentation
 
-**Current Celeste version**: `0.1.7` (pre-1.0.0)
+**Current Celeste version**: `0.1.9` (pre-1.0.0)
 
 ### Post-1.0.0 (Stable)
 
@@ -441,7 +441,7 @@ npm view @whykusanagi/corrupted-theme version
 
 **Last Updated**: 2025-12-13
 **Version**: 1.0.0
-**Current Celeste Version**: 0.1.7
+**Current Celeste Version**: 0.1.9
 **Versioning Spec**: Semantic Versioning 2.0.0
 **Maintainer**: Celeste Brand System
 **Status**: ✅ Active Policy