Skip to content

docs(0.2.0): presentation overhaul — README, demo pages, components/platforms docs#21

Merged
whykusanagi merged 6 commits into
mainfrom
feat/0.2.0-presentation-overhaul
May 18, 2026
Merged

docs(0.2.0): presentation overhaul — README, demo pages, components/platforms docs#21
whykusanagi merged 6 commits into
mainfrom
feat/0.2.0-presentation-overhaul

Conversation

@whykusanagi
Copy link
Copy Markdown
Owner

Summary

Pre-publish presentation overhaul for 0.2.0. The functional release (PRs #15#20) shipped 19 new modules + CDN distribution + canonical JSON + container redesign, but the README, demo pages, and component-level docs were still describing the 0.1.x surface. This PR aligns the presentation layer with what actually ships.

What changed

README.md (967 → 1420 lines, +453)

New sections:

  • CDN Distribution — cdn.whykusanagi.xyz + cdn.nikkers.cc, pinned vs @latest, SRI guidance
  • Canonical Data (JSON Source of Truth) — src/data/ files, 6-pool context API, getPhraseByContext, link to CROSS_LANGUAGE_CONTRACT
  • Container Layout (0.2.0 Breaking Change) — modifier-class system, migration link
  • NSFW Option Canonicalization — deprecation table + canonical examples
  • Drift Reconvergence Imports — CorruptionCharsets, CorruptionManager, CRTEffects, animation-blocks (10 classes), CorruptedParticlesBackground
  • Widgets — Toast, ClockWidget, EventBar, LogoBanner, Lightbox, NsfwReveal, PngExport, WebSocketManager
  • Core Utilities — random-utils, time-utils, clipboard-helpers, url-state
  • CSS Utilities — .scrollbar-corrupted, seamless-background

Updated:

  • Installation CDN block (was "when mirrored", now active)
  • Project Architecture tree (src/data/, all new modules, cdn-worker/)
  • CSS & JS Imports (19 new module paths)
  • Table of Contents

Demo HTML pages (~250 lines added)

  • index.html (root, live at corrupted.whykusanagi.xyz): new "0.2.0 New Components" card + 8-tile section, CDN install option
  • examples/index.html: same updates
  • examples/showcase.html: 0.2.0 components banner with 8 link buttons
  • examples/showcase-complete.html: full inline showcase section for the 8 new example pages

Component & platform docs

  • docs/components/COMPONENT_LIBRARY.md: 19-entry 0.2.0 JS library catalog
  • docs/components/ANIMATION_GUIDELINES.md: CRT effects + animation-blocks keyframes
  • docs/components/GLASSMORPHISM.md: new container variants + @supports fallback
  • docs/platforms/WEB_IMPLEMENTATION.md: CDN consumption section
  • docs/platforms/COMPONENT_MAPPING.md: 19-entry 0.2.0 mapping table
  • docs/platforms/CLI_IMPLEMENTATION.md: cross-language data contract reference + Go embed example
  • docs/platforms/NPM_PACKAGE.md: CDN URL fixed to @0.2.0, speculative migration section replaced with actual 0.2.0 summary

Refreshed 0.1.x-era docs

  • docs/CORRUPTION_PHRASES.md: prominent 0.2.0 redirect banner pointing to src/data/phrases.json + CROSS_LANGUAGE_CONTRACT
  • docs/CHARACTER_LEVEL_CORRUPTION.md: 0.2.0 redirect for charsets
  • docs/PERSONALITY.md: documents PERSONALITY_PHRASES derivation from nsfw.memory + nsfw.void pools
  • docs/brand/COLOR_SYSTEM.md + docs/brand/DESIGN_TOKENS.md: src/data/colors.json as canonical color source

Verified current (no edits needed)

  • docs/components/INTERACTIVE_STATES.md (hover/focus/active patterns unchanged)
  • docs/CAPABILITIES.md (Celeste AI persona doc, not a component inventory)
  • docs/STYLE_GUIDE.md (voice/tone rules, version-independent)

Test plan

  • `npm test` — 159/159 pass
  • `npm run validate-data` clean
  • README sanity grep: Toast 12×, ClockWidget 4×, CDN 8×, @latest 7×, getPhraseByContext 3×, MIGRATION_CONTAINER 2×
  • No existing docs broken (all updates are additive or refresh prominent banners)
  • All cross-doc links use relative paths that resolve

After merge

This unblocks the npm publish gate. The functional release + presentation are now aligned; the only step remaining is human-approved `npm publish --access public` + the CDN re-publish + post-publish smoke + realignment ticket filing.

🤖 Generated with Claude Code

whykusanagi and others added 6 commits May 18, 2026 01:14
- Add CDN Distribution section (cdn.whykusanagi.xyz + cdn.nikkers.cc)
- Add Canonical Data section (src/data/ JSON, 6-pool context API)
- Add Container Layout BREAKING-change callout + migration link
- Add NSFW option canonicalization note
- Expand Component Quick Reference with 19 new component subsections
  (Toast, ClockWidget, EventBar, LogoBanner, Lightbox, NsfwReveal,
  PngExport, WebSocketManager, CorruptionManager, CRTEffects, 10
  animation-blocks classes, CorruptionCharsets,
  CorruptedParticlesBackground, plus core utilities)
- Update CSS & JS Imports to list new modules
- Update Table of Contents
- Preserve existing voice + structure; link out to COMPONENTS_REFERENCE,
  CDN_CONSUMPTION, MIGRATION_CONTAINER docs instead of inlining API tables

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- index.html (live site at corrupted.whykusanagi.xyz): add "0.2.0 New
  Components" card to Explore grid + "0.2.0 Examples" quick-links
  section covering all 8 new example pages. Add CDN install option to
  Quick Install block.
- examples/index.html: same updates as root index (relative paths).
- examples/showcase.html: add "0.2.0 New Components" banner section
  after hero with btn links to all 8 new examples. Extend nav Examples
  submenu with Animation Blocks, CRT Effects, Corruption Manager, and
  Widgets Showcase entries.
- examples/showcase-complete.html: add "#v020-components" section with
  glass-card tiles for all 8 new components (Animation Blocks, CRT
  Effects, Corruption Manager, Particles Background, Widgets Showcase,
  Utilities, PNG Export, WebSocket Manager). Add nav anchor and
  Examples submenu entries.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…assmorphism variants)

- COMPONENT_LIBRARY: add 0.2.0 JS library section (19 new components
  across animation-blocks, crt-effects, widgets, utilities); bump
  web component total to 75; link COMPONENTS_REFERENCE for full APIs
- ANIMATION_GUIDELINES: add CRT effects section (.glitch-word,
  .glitch-kanji, scanline-movement/crt-flicker keyframes, CRTEffects
  class); bump version to 0.2.0
- GLASSMORPHISM: add 0.2.0 container variant section
  (.glass-container-dark/subtle/gradient/animated, color modifiers
  -cyan/-purple/-magenta, @supports fallback); bump version to 0.2.0

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…, cross-language contract)

- WEB_IMPLEMENTATION: add CDN Consumption section linking to
  CDN_CONSUMPTION.md with quick-reference snippet; bump version
- COMPONENT_MAPPING: add 0.2.0 JS library component mapping table
  (19 entries) with CLI equivalent notes; bump version
- CLI_IMPLEMENTATION: add Cross-Language Data Contract section
  referencing src/data/*.json and CROSS_LANGUAGE_CONTRACT.md;
  update related docs links; bump version
- NPM_PACKAGE: fix CDN URL from @0.1.9 to @0.2.0; replace speculative
  future migration guide with actual 0.2.0 migration summary pointing
  to MIGRATION_CONTAINER_0.2.0.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…onality phrases)

- CORRUPTION_PHRASES: add prominent 0.2.0 redirect header pointing at
  src/data/phrases.json + CROSS_LANGUAGE_CONTRACT; update related files
  section; doc preserved as narrative context
- CHARACTER_LEVEL_CORRUPTION: add 0.2.0 note redirecting charset
  consumers to src/data/charsets.json + corruption-charsets.js; update
  related files section
- PERSONALITY: add Personality Phrase Pools section documenting the
  sfw/nsfw void+memory pools in phrases.json that power TypingAnimation,
  CorruptedParticles, and custom overlays; add canonical JSON source link

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- COLOR_SYSTEM: add 0.2.0 header note that src/data/colors.json is the
  machine-readable source of truth for the 6-color corruption palette;
  bump version to 0.2.0
- DESIGN_TOKENS: note canonical color subset at src/data/colors.json
  alongside the full design-tokens.json; link CROSS_LANGUAGE_CONTRACT
  for schema; bump version to 0.2.0

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
corrupted-theme 2f72b20 Commit Preview URL

Branch Preview URL
May 18 2026, 08:34 AM

@whykusanagi whykusanagi merged commit 11be606 into main May 18, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant