📋 v0.3.0 Bug Fixes and Enhancements Tracking

[JakeLin]

This is a master tracking issue for all identified bugs and improvements for the next release.

🔴 Critical (Blocking)

• 🐛 Bug Report: Carousel Navigation Icons Not Visible #1 - Carousel navigation icons not displaying (CSS mask-image issue)
• ⚠️ Bug Report: React Warning for aspectRatio Prop on Card.Image #2 - Invalid aspectRatio prop warning on Card.Image

🟡 High Priority (DX)

• 💡 Feature Request: Export ChatGPT Apps SDK Type Definitions #3 - Export Window.openai type definitions globally
• 🐛 Bug Report: OpenAI Hooks Missing or Not Working #4 - Implement and export OpenAI hooks (useOpenAiGlobal, useWidgetState, useTheme, useMaxHeight)

🟢 Nice to Have

• No Theme Detection Hook #5 - Export CSS design tokens as TypeScript objects
• CSS Variables Not Type-Safe #6 - Add loading="lazy" support to Card.Image
• Missing Image Lazy Loading #7 - Export all component prop types for easier extension
• No Carousel Performance Optimization for Large Lists #8 - Add virtualization support to Carousel for large lists
• Missing Common Utility Components #9 - Add utility components (ErrorBoundary, LoadingSpinner, EmptyState)
• Badge Variant Types Not Exported #10 - Add theme change event listener

Release Plan

Target: v0.3.0

Breaking Changes: None

Fixes:

• Navigation icons visible
• No React warnings
• All advertised hooks working

New Features:

• Global TypeScript types
• Better DX with type exports

Testing Strategy

1. Fix issues in order of priority
2. Test each fix in Storybook
3. Test in real Vite project
4. Test in ChatGPT environment
5. Verify build size impact
6. Update documentation

Implementation Order

Week 1: Critical Fixes

1. Fix Carousel navigation icons (🐛 Bug Report: Carousel Navigation Icons Not Visible #1)
2. Fix aspectRatio prop warning (⚠️ Bug Report: React Warning for aspectRatio Prop on Card.Image #2)

Week 2: DX Improvements
4. Add Window.openai types (#3)
5. Implement OpenAI hooks (#4)
6. Publish v0.2.0 minor release

Future: Nice-to-Haves
7. Design token exports (#5)
8. Lazy loading support (#6)
9. Type exports (#7)
10. Performance optimizations (#8-10)

Related

• Storybook: https://ainativekit.github.io/ainativekit-ui
• NPM: https://www.npmjs.com/package/@ainativekit/ui
• GitHub: https://github.com/AINativeKit/ainativekit-ui

Community Impact

Pain Points Addressed:

• Invisible navigation buttons (major confusion)
• Console spam (annoying but non-blocking)
• Type definition repetition (DX issue)
• Missing advertised features (trust/expectation gap)

Success Metrics

• Zero critical bugs in v0.3.0
• All README features working
• Positive community feedback
• Increased Storybook usage
• More GitHub stars/forks