@whykusanagi/corrupted-theme 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -11,13 +11,51 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - [ ] CDN distribution via jsDelivr
 - [ ] Figma design system (components library)
 - [ ] Storybook integration for component showcase
-- [ ] SCSS/SASS version for advanced customization
-- [ ] CSS-in-JS library bindings (Styled Components, Emotion)
-- [ ] Dark mode + light mode theme switcher example
-- [ ] Animation performance improvements
-- [ ] Web font optimization
-- [ ] Additional color palette presets
-- [ ] Tailwind CSS integration guide
+
+---
+
+## [0.1.5] - 2026-01-15
+
+### Fixed
+- **Corruption Example Styling** - Aligned all three corruption examples with theme.css design system
+  - examples/basic/corrupted-text.html - Now uses CSS variables and glassmorphism
+  - examples/basic/typing-animation.html - Consistent button and component styling
+  - examples/advanced/nsfw-corruption.html - Proper navbar and design system integration
+- **Documentation Links** - Fixed broken markdown links across all 12 HTML example files
+  - Updated "Docs" navigation to point to showcase-complete.html instead of .md files
+  - Ensures all documentation is accessible in browser
+
+### Changed
+- **Corruption Examples** - Replaced custom inline styles with theme.css design system
+  - Now uses CSS variables (--accent, --bg, --glass, --spacing-*, etc.)
+  - Added proper navbar component matching other examples
+  - Applied consistent .example-group sections with glassmorphism
+  - Added Font Awesome icons throughout
+  - All corruption functionality and interactivity preserved
+
+---
+
+## [0.1.4] - 2025-12-15
+
+### Fixed
+- **Navigation Consistency** - Moved index.html to root, fixed all navigation paths
+- **Asset Loading** - Corrected CSS and documentation paths for root-level index
+
+### Added
+- **Complete Corruption Phrase Library** - Added 67 official phrases to character-corruption.js
+  - 30 technical phrases (6 categories: loading, processing, analyzing, corrupting, watching, void)
+  - 30 personality phrases (English, Japanese, Romaji)
+  - `getRandomPhrase()` helper function
+- **Animation Utilities Showcase** - Added comprehensive examples for all 21+ animation classes
+- **VERSION_REFERENCES.md** - Complete version tracking documentation for future releases
+
+### Changed
+- **npm Package** - Excluded 7 internal docs from npm release (IMPLEMENTATION_VALIDATION, FUTURE_WORK, CAPABILITIES, PERSONALITY, ROUTING, LLM_PROVIDERS, CLI_IMPLEMENTATION)
+- **Documentation** - Extended CORRUPTION_PHRASES.md with Celeste demon/succubus personality phrases
+
+### Documentation
+- Added 33 governance, brand, component, and platform documentation files
+- All version references updated consistently across project
 
 ---
 

package/README.md

@@ -30,10 +30,32 @@ A production-ready glassmorphic design system for cinematic, cyberpunk-inspired
 - **Glassmorphism-first** visual language with layered depth, gradients, and scanlines.
 - **Systemized tokens** (`src/css/variables.css`) for colors, typography, spacing, motion, and elevation.
 - **Bootstrap-scale coverage** of components (navigation, forms, data display, API docs, Nikke-specific UI).
-- **First-visit cinematic experiences** via `corrupted-text.js` and `corruption-loading.js`.
+- **Buffer corruption effects** with SFW/NSFW phrase modes (Pattern 1 & 2 from spec).
 - **WCAG AA** compliance, motion safety, and keyboard support baked in.
 - **Dockerized showcase** at `examples/showcase-complete.html` for instant QA.
 
+### Content Warnings
+
+This package includes two corruption animation modes:
+
+**SFW Mode (Default)**
+- Playful anime-style expressions
+- Cute/teasing phrases
+- Atmospheric corruption themes
+- Safe for professional and public projects
+
+**NSFW Mode (Opt-in Required)**
+- ⚠️ **18+ Content Warning**
+- Explicit intimate/sexual phrases
+- Loss of control themes
+- **NOT suitable for:**
+  - Professional/corporate projects
+  - Public streams without 18+ rating
+  - Educational contexts
+  - All-ages content
+
+**All examples and default behavior use SFW mode.** NSFW requires explicit `{ nsfw: true }` configuration.
+
 ## Installation
 ### npm (public registry)
 ```bash
@@ -354,26 +376,49 @@ document.addEventListener('click', e => {
 </div>
 ```
 
-### Corrupted Text & Loader
+### Corrupted Text & Buffer Corruption
+
+**Pattern 1: Character-Level Corruption (Visual Glitch)**
 ```html
-<span class="corrupted-text" data-text="CORRUPTED">CORRUPTED</span>
-<span class="glitch-kanji">
-  <span class="glitch-word" data-text="CORRUPTED TEXT">CORRUPTED TEXT</span>
+<!-- Multi-language cycling with character-level glitch -->
+<span class="corrupted-multilang"
+      data-english="Hello World"
+      data-romaji="konnichiwa"
+      data-hiragana="こんにちは"
+      data-katakana="コンニチハ"
+      data-kanji="今日は">
 </span>
+
+<script type="module" src="@whykusanagi/corrupted-theme/src/core/corrupted-text.js"></script>
 ```
+
+**Pattern 2: Phrase Flickering (Buffer Corruption)**
 ```html
-<video class="background-media" autoplay muted loop playsinline>
-  <source src="/media/corruption-loop.mp4" type="video/mp4" />
-</video>
-<script type="module" src="@whykusanagi/corrupted-theme/src/lib/corruption-loading.js"></script>
-<script>
-showCorruptionLoading();                // auto once every 72h
-// showCorruptionLoading({ force: true });
+<!-- Typing animation with SFW phrase buffer corruption -->
+<div class="typing-output" id="typing1"></div>
+
+<script type="module">
+import { TypingAnimation } from '@whykusanagi/corrupted-theme/src/core/typing-animation.js';
+
+const typing = new TypingAnimation(document.getElementById('typing1'), {
+    typingSpeed: 40,      // chars/sec
+    glitchChance: 0.08,   // 8% buffer corruption
+    nsfw: false           // SFW mode (default)
+});
+
+typing.start('Neural corruption detected... System Online');
 </script>
 ```
-Japanese overlay text is sourced from the lewd phrase array inside `examples/showcase-complete.html`; supply your own by updating the data attribute or reusing the script snippet.
+
+**⚠️ Content Classification:**
+- **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.
 
 ## Animations & Experience Layer
+
+### Standard CSS Animations
 Class | Behavior
 --- | ---
 `.fade-in`, `.fade-up`, `.slide-in-left/right`, `.scale-in` | Standard entrance motions synchronized to `var(--transition)`
@@ -381,8 +426,27 @@ Class | Behavior
 `.corrupted-text`, `.corrupted-strong` | Brute-force corruption effect for headings and pills
 `.scanlines`, `.tear`, `.data-corrupt` | Utility effects inspired by whykusanagi.xyz hero
 `.spinner`, `.loading-bar`, `.progress-bar` | Loading indicators with shimmer + accent variants
-`.corruption-loading` (JS) | Full-screen loader with 72h replay timer
-`.corrupted-multilang` (JS) | First-visit Japanese/English/Romaji cycling text
+
+### 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`
+
+**TypingAnimation** - Pattern 2: Phrase Flickering (Buffer Corruption)
+- Simulates neural network decoding corrupted data buffer
+- Phrases flicker through before revealing final text
+- 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
+
+**Corruption Phrases Library**
+- Normalized SFW/NSFW phrase sets
+- Separate exports for each mode
+- Helper functions for random phrase selection
+- Module: `src/core/corruption-phrases.js`
 
 ## Nikke Utilities
 ```html

package/docs/governance/DESIGN_SYSTEM_GOVERNANCE.md

@@ -220,8 +220,8 @@ Reviewers verify:
 
 | Type | Frequency | Version Bump | Example |
 |------|-----------|--------------|---------|
-| **Patch** | As needed | 0.0.x | 0.1.2 → 0.1.3 |
-| **Minor** | Monthly | 0.x.0 | 0.1.3 → 0.2.0 |
+| **Patch** | As needed | 0.0.x | 0.1.2 → 0.1.4 |
+| **Minor** | Monthly | 0.x.0 | 0.1.4 → 0.2.0 |
 | **Major** | Quarterly | x.0.0 | 0.2.0 → 1.0.0 |
 
 ### Release Phases

package/docs/governance/VERSION_REFERENCES.md

@@ -2,7 +2,7 @@
 
 **Purpose**: Complete list of all files containing version numbers that must be updated when releasing a new version.
 
-**Current Version**: 0.1.3
+**Current Version**: 0.1.4
 
 ---
 
@@ -12,7 +12,7 @@
 **Location**: `/package.json`
 **Line**: 3
 ```json
-"version": "0.1.3"
+"version": "0.1.4"
 ```
 
 ### 2. CHANGELOG.md
@@ -62,10 +62,10 @@
 ### 7. showcase-complete.html
 **Location**: `/examples/showcase-complete.html`
 **Lines to update**:
-- Line 1135: "NEW v0.1.3" badge (keep for current release, change to version number after)
-- Line 1317: "NEW v0.1.3" badge (keep for current release, change to version number after)
+- Line 1135: "NEW v0.1.4" badge (keep for current release, change to version number after)
+- Line 1317: "NEW v0.1.4" badge (keep for current release, change to version number after)
 - Line 1697: Footer version `v0.1.X`
-- Line 1835: Comment `<!-- NEW v0.1.3: ... -->`
+- Line 1835: Comment `<!-- NEW v0.1.4: ... -->`
 - Line 1922: Toast message `Welcome to Corrupted Theme v0.1.X!`
 
 ### 8. Other Example Pages
@@ -77,13 +77,13 @@ All have footer version references like:
 <p>... • Corrupted Theme v0.1.0</p>
 ```
 
-**Update these to current version** (currently showing v0.1.0, should be v0.1.3)
+**Update these to current version** (currently showing v0.1.0, should be v0.1.4)
 
 ---
 
 ## Version Bump Procedure
 
-When releasing a new version (e.g., 0.1.3 → 0.1.4):
+When releasing a new version (e.g., 0.1.4 → 0.1.4):
 
 ### Step 1: Core Files
 ```bash
@@ -115,7 +115,7 @@ npm version patch  # or minor, or major
 #    - Footer
 
 # 7. Update showcase-complete.html
-#    - Change "NEW v0.1.3" badges to just version number
+#    - Change "NEW v0.1.4" badges to just version number
 #    - Update footer
 #    - Update toast message
 
@@ -171,19 +171,19 @@ When updating, search for these patterns:
 
 ```bash
 # Version with v prefix
-"v0.1.3"
+"v0.1.4"
 "v0\.1\.3"
 
 # Version without v prefix
-"0.1.3"
+"0.1.4"
 "0\.1\.3"
 
 # NPM package version
-"@whykusanagi/corrupted-theme@0.1.3"
+"@whykusanagi/corrupted-theme@0.1.4"
 
 # NEW badge references
-"NEW v0.1.3"
-"NEW in v0.1.3"
+"NEW v0.1.4"
+"NEW in v0.1.4"
 ```
 
 ---
@@ -192,18 +192,18 @@ When updating, search for these patterns:
 
 **Files showing OLD versions that need updating:**
 
-1. `/examples/showcase.html` - Shows v0.1.0 (should be v0.1.3)
-2. `/examples/form.html` - Shows v0.1.0 (should be v0.1.3)
-3. `/examples/layout.html` - Shows v0.1.0 (should be v0.1.3)
-4. `/examples/card.html` - Shows v0.1.0 (should be v0.1.3)
-5. `/examples/button.html` - Shows v0.1.0 (should be v0.1.3)
-6. `/examples/nikke-team-builder.html` - Shows v0.1.0 (should be v0.1.3)
-7. `/examples/showcase-complete.html` footer - Shows v0.1.0 (should be v0.1.3)
-8. `/examples/index.html` - Shows v0.1.2 (should be v0.1.3)
-9. `/docs/platforms/NPM_PACKAGE.md` - Shows v0.1.2 (should be v0.1.3)
-10. `/docs/governance/VERSION_MANAGEMENT.md` - Shows v0.1.2 (should be v0.1.3)
-
-**Action Required**: Update all example footers and documentation to v0.1.3
+1. `/examples/showcase.html` - Shows v0.1.0 (should be v0.1.4)
+2. `/examples/form.html` - Shows v0.1.0 (should be v0.1.4)
+3. `/examples/layout.html` - Shows v0.1.0 (should be v0.1.4)
+4. `/examples/card.html` - Shows v0.1.0 (should be v0.1.4)
+5. `/examples/button.html` - Shows v0.1.0 (should be v0.1.4)
+6. `/examples/nikke-team-builder.html` - Shows v0.1.0 (should be v0.1.4)
+7. `/examples/showcase-complete.html` footer - Shows v0.1.0 (should be v0.1.4)
+8. `/examples/index.html` - Shows v0.1.2 (should be v0.1.4)
+9. `/docs/platforms/NPM_PACKAGE.md` - Shows v0.1.2 (should be v0.1.4)
+10. `/docs/governance/VERSION_MANAGEMENT.md` - Shows v0.1.2 (should be v0.1.4)
+
+**Action Required**: Update all example footers and documentation to v0.1.4
 
 ---
 

package/docs/platforms/NPM_PACKAGE.md

@@ -31,7 +31,7 @@
 ```json
 {
   "name": "@whykusanagi/corrupted-theme",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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.2/dist/theme.css">
+<link rel="stylesheet" href="https://unpkg.com/@whykusanagi/corrupted-theme@0.1.4/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.2
+Example: 0.1.4
          │ │ └─ Patch: Bug fixes (backward compatible)
          │ └─── Minor: New features (backward compatible)
          └───── Major: Breaking changes
@@ -674,7 +674,7 @@ Example: 0.1.2
 
 | Version | Date | Changes | Migration |
 |---------|------|---------|-----------|
-| **0.1.2** | 2025-12-10 | Current stable release | N/A |
+| **0.1.4** | 2025-12-10 | Current stable release | N/A |
 | 0.1.1 | 2025-11-15 | Added interactive states | None required |
 | 0.1.0 | 2025-10-01 | Initial public release | N/A |
 
@@ -691,7 +691,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.2
+npm install @whykusanagi/corrupted-theme@0.1.4
 
 # Update to latest (including major - may have breaking changes)
 npm install @whykusanagi/corrupted-theme@latest
@@ -849,6 +849,6 @@ import '@whykusanagi/corrupted-theme/src/css/components.css';
 
 **Last Updated**: 2025-12-13
 **Version**: 1.0.0
-**Package Version**: 0.1.2
+**Package Version**: 0.1.4
 **Maintainer**: Celeste Brand System
 **Status**: ✅ Production Ready