@whykusanagi/corrupted-theme 0.1.8 → 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,7 +450,7 @@ 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
 
@@ -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.8` (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.8
+**Current Celeste Version**: 0.1.9
 **Versioning Spec**: Semantic Versioning 2.0.0
 **Maintainer**: Celeste Brand System
 **Status**: ✅ Active Policy

package/docs/governance/VERSION_REFERENCES.md

@@ -2,7 +2,7 @@
 
 **Purpose**: Canonical list of every file containing a version number. Update all of these when releasing a new version.
 
-**Current Version**: 0.1.8
+**Current Version**: 0.1.9
 
 ---
 
@@ -10,8 +10,8 @@
 
 | # | File | Location(s) | What to change |
 |---|------|-------------|----------------|
-| 1 | `package.json` | line 3 | `"version": "0.1.8"` |
-| 2 | `package-lock.json` | lines 3 and 9 | `"version": "0.1.8"` (both occurrences) |
+| 1 | `package.json` | line 3 | `"version": "0.1.9"` |
+| 2 | `package-lock.json` | lines 3 and 9 | `"version": "0.1.9"` (both occurrences) |
 | 3 | `CHANGELOG.md` | top of file | Add new `## [0.1.X] - YYYY-MM-DD` section |
 | 4 | `README.md` | search for old ver | Any install/usage examples with pinned version |
 | 5 | `index.html` *(root)* | lines 476, 725 | Hero badge `v0.1.X` and footer `Corrupted Theme v0.1.X` |
@@ -47,8 +47,10 @@
 ## One-Command Version Bump
 
 ```bash
-NEW=0.1.9
-OLD=0.1.8
+# Set these BEFORE running — OLD must be the current version on main,
+# NEW must be the version you're bumping to. They must differ.
+NEW=0.1.10   # ← target version
+OLD=0.1.9    # ← currently shipped version (matches package.json today)
 
 # 1. Core package files (auto-syncs both package.json and package-lock.json)
 npm version patch --no-git-tag-version   # or minor / major
@@ -63,7 +65,9 @@ sed -i '' "s/${OLD}/${NEW}/g" \
   docs/governance/VERSION_MANAGEMENT.md \
   docs/platforms/NPM_PACKAGE.md
 
-# 4. Add 0.1.9 row to NPM_PACKAGE.md version table manually
+# 4. Add the new ${NEW} row to NPM_PACKAGE.md version table manually
+#    (sed mangles the most-recent table row description — restore the OLD
+#    row's description and add a fresh NEW row above it)
 
 # 5. Verify nothing left
 grep -rn "${OLD}" . --include="*.html" --include="*.md" --include="*.json" \
@@ -75,7 +79,7 @@ grep -rn "${OLD}" . --include="*.html" --include="*.md" --include="*.json" \
 ## Verify Current State
 
 ```bash
-# Quick check — should only show 0.1.8 in live files, old versions only in CHANGELOG
+# Quick check — should only show 0.1.9 in live files, old versions only in CHANGELOG
 grep -rn "0\.1\.[0-9]" . --include="*.html" --include="*.json" \
   | grep -v node_modules | grep -v ".git"
 ```

package/docs/platforms/NPM_PACKAGE.md

@@ -31,7 +31,7 @@
 ```json
 {
   "name": "@whykusanagi/corrupted-theme",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Premium corrupted AI aesthetic with glassmorphism and translation-failure linguistics",
   "author": "Kusanagi <you@example.com>",
   "license": "MIT",
@@ -80,7 +80,7 @@ pnpm add @whykusanagi/corrupted-theme
 
 ```html
 <!-- Full theme (8.2KB gzipped) -->
-<link rel="stylesheet" href="https://unpkg.com/@whykusanagi/corrupted-theme@0.1.8/dist/theme.css">
+<link rel="stylesheet" href="https://unpkg.com/@whykusanagi/corrupted-theme@0.1.9/dist/theme.css">
 ```
 
 ### Local Development
@@ -664,7 +664,7 @@ The package follows [Semantic Versioning 2.0.0](https://semver.org/):
 ```
 MAJOR.MINOR.PATCH
 
-Example: 0.1.8
+Example: 0.1.9
          │ │ └─ Patch: Bug fixes (backward compatible)
          │ └─── Minor: New features (backward compatible)
          └───── Major: Breaking changes
@@ -674,7 +674,8 @@ Example: 0.1.8
 
 | Version | Date | Changes | Migration |
 |---------|------|---------|-----------|
-| **0.1.8** | 2026-03-01 | GLSL vortex, Canvas particles, new JS components | N/A |
+| **0.1.9** | 2026-04-19 | CorruptedText dedup, TypingAnimation buffer redesign, NSFW page consolidation, layout fix, orphan docs removed, CI workflow | N/A |
+| 0.1.8 | 2026-03-01 | GLSL vortex, Canvas particles, new JS components | N/A |
 | 0.1.7 | 2026-02-07 | Security, lifecycle, new components | N/A |
 | 0.1.6 | 2026-01-15 | Package cleanup | N/A |
 | 0.1.4 | 2025-12-10 | Character corruption, components | N/A |
@@ -693,7 +694,7 @@ npm update @whykusanagi/corrupted-theme
 npm install @whykusanagi/corrupted-theme@^0.2.0
 
 # Update to specific version
-npm install @whykusanagi/corrupted-theme@0.1.8
+npm install @whykusanagi/corrupted-theme@0.1.9
 
 # Update to latest (including major - may have breaking changes)
 npm install @whykusanagi/corrupted-theme@latest
@@ -851,6 +852,6 @@ import '@whykusanagi/corrupted-theme/src/css/components.css';
 
 **Last Updated**: 2025-12-13
 **Version**: 1.0.0
-**Package Version**: 0.1.8
+**Package Version**: 0.1.9
 **Maintainer**: Celeste Brand System
 **Status**: ✅ Production Ready

package/examples/advanced/glsl-vortex.html

@@ -183,7 +183,6 @@
             <a href="../layout.html"><i class="fas fa-columns"></i> Layouts</a>
             <a href="../basic/corrupted-text.html"><i class="fas fa-terminal"></i> Character Corruption</a>
             <a href="../basic/typing-animation.html"><i class="fas fa-keyboard"></i> Buffer Corruption</a>
-            <a href="nsfw-corruption.html"><i class="fas fa-exclamation-triangle"></i> NSFW (18+)</a>
           </div>
         </li>
         <li><a href="../showcase-complete.html"><i class="fas fa-book"></i> Docs</a></li>

package/examples/advanced/particles-bg.html

@@ -173,7 +173,6 @@
             <a href="../layout.html"><i class="fas fa-columns"></i> Layouts</a>
             <a href="../basic/corrupted-text.html"><i class="fas fa-terminal"></i> Character Corruption</a>
             <a href="../basic/typing-animation.html"><i class="fas fa-keyboard"></i> Buffer Corruption</a>
-            <a href="nsfw-corruption.html"><i class="fas fa-exclamation-triangle"></i> NSFW (18+)</a>
           </div>
         </li>
         <li><a href="../showcase-complete.html"><i class="fas fa-book"></i> Docs</a></li>

package/examples/basic/corrupted-text.html

@@ -107,7 +107,6 @@
             <a href="../layout.html"><i class="fas fa-columns"></i> Layouts</a>
             <a href="corrupted-text.html" class="active"><i class="fas fa-terminal"></i> Character Corruption</a>
             <a href="typing-animation.html"><i class="fas fa-keyboard"></i> Buffer Corruption</a>
-            <a href="../advanced/nsfw-corruption.html"><i class="fas fa-exclamation-triangle"></i> NSFW (18+)</a>
           </div>
         </li>
         <li><a href="../showcase-complete.html"><i class="fas fa-book"></i> Docs</a></li>
@@ -211,12 +210,12 @@ instance.start();</div>
         <li><strong>Character Sets:</strong> Katakana, Hiragana, Romaji, Symbols for visual glitch</li>
         <li><strong>Colors:</strong> Magenta/Purple corruption, White for decoded text</li>
         <li><strong>Auto-initialization:</strong> Elements with class <code>corrupted-multilang</code></li>
-        <li><strong>Script:</strong> <code>src/core/corrupted-text.js</code></li>
+        <li><strong>Script:</strong> <code>src/lib/corrupted-text.js</code></li>
       </ul>
     </section>
   </div>
 
-  <script src="../../src/core/corrupted-text.js"></script>
+  <script src="../../src/lib/corrupted-text.js"></script>
   <script>
     // Example 2: Manual control
     const example2 = document.getElementById('example2');