Changelog

✨ Added

• • Live2DWidget now renders inside a self-contained iframe, so consumers no longer need to hand-roll their own isolated widget wrapper.
• • Added scale and bottomOffset props to control widget sizing/position without extra CSS.

🐛 Fixed

• • Eliminated "Cannot read properties of null (reading 'removeChild')" crashes by no longer mutating the host document's DOM; all widget DOM lives inside the iframe document.

🐛 Fixed

• • Hardened DOM cleanup during widget lifecycle transitions to reduce removeChild race crashes.

🧪 Test App

• • Reworked the demo runtime to isolate Live2D execution from App Router UI updates.
• • Restored demo interactions for model switch and mouse tracking in the isolated widget.
• • Increased isolated widget viewport sizing so taller models are less likely to be clipped.

🐛 Fixed

• • Fixed model switching where only the first model persisted after selection changes.
• • Reset Live2D widget runtime config before each re-initialization so jsonPath updates correctly.
• • Updated script loading flow to include both L2Dwidget.min.js and L2Dwidget.0.min.js, preventing partial runtime initialization.

🐛 Fixed

• • Fixed Live2D initialization context binding (this) to prevent runtime failures such as "Cannot read properties of undefined (reading 'emit')".
• • Added preflight model JSON validation before widget initialization to fail fast with actionable errors.

⚙️ Dev Experience

• • Added dev:test:clean and test app dev:clean scripts to clear stale .next artifacts.

🔧 Changed

• • Updated default model host URL to use the new GitHub username 2hjaito.
• • Updated package metadata links (repository, bugs) to the new GitHub profile.

🐛 Fixed

• • Hardened Live2D script loading to avoid duplicate injection during React StrictMode remounts.
• • Improved initialization flow to reduce async race conditions in Next.js App Router projects.
• • Added timeout guard while waiting for #live2d-widget to prevent long-running render loops.

🚀 Major Release

• • Custom baseUrl for self-hosted models.
• • Position, size, opacity, hoverOpacity controls.
• • Random model mode and loading fallback.
• • React 18/19 support with stronger TypeScript exports.

🐛 Fixed

• • Avoided unsafe global delete operation.
• • Improved unmount cleanup safety.

🐣 Initial release

• • Simple <Live2DWidget modelName="..." /> component.
• • Injects live2d-widget from CDN.
• • Supports 20+ Live2D models.