Ultra Vehicle Card v2.0- The "Are We There Yet?" Update! 🚀

Hold onto your dashboards, folks! Version 2.0 isn't just an update; it's a full engine swap! We tossed out the old JavaScript jalopy and rebuilt the Ultra Vehicle Card from scratch using TypeScript, Lit, and a generous sprinkle of digital magic. ✨ It's faster, slicker, and packed with more goodies than a road trip snack bag.

🚨 WARNING: Major Tune-Up Required! 🚨
Because we rebuilt everything, your old v1.x configurations are about as useful as a screen door on a submarine. You'll need to reconfigure your cards using the shiny new editor or YAML. Sorry, but trust us, it's worth it!

🎉 What's New Under the Hood? (Features Galore!)

• Bar Buffet! 📊: Remember those fixed spots for battery, range, etc.? Gone! Now we have a bars array. Add as many progress bars as you want! Track your flux capacitor charge level, your coffee intake, whatever! Each bar gets:
  • Its own entities (main, limit, left/right side info).
  • Snazzy custom titles.
  • A full paint job: customize colors for the bar, background, border, and text. Even pick text sizes!
  • Body kits: Choose bar size (thin to thick) and corner style (round, square, rounded-square).
  • Optional groovy gradients (because solid colors are so last year).
  • Animations! Make your bar pulse when charging or do the cha-cha (animation type pending 😉).
• Icon Grid Overhaul! 🖼️: Forget the old grid; say hello to icon_rows! Now you're the Picasso of your icon layout.
  • Control row width, alignment, and spacing like a pro.
  • Icons got smarter (IconConfig):
    • Supercharged Template Mode! 🧙‍♂️ Unleash your inner wizard! You can now use Home Assistant templates ({{ }}) to dynamically control the active/inactive icon and state based on complex conditions. Want an icon to change based on multiple entity states or attributes? Now you can! This allows for some truly amazing and customized icon behaviors.
    • Decide exactly what shows: state, name, units? You choose!
    • More click actions: Navigate, open URLs, call services – make those icons do something!
    • Backgrounds! Give icons little circle/square/rounded outfits and colors.
    • Even more control over text position and alignment.
• Picture Perfect! 📸:
  • Your car can now have mood swings! Use action_entity to change the main image based on another sensor (e.g., show a charging pic when plugged in). Map different states to different images!
  • Got an image that's slightly off? Use the new cropping tool! Snip, snip! ✂️
• Layout Your Way! 📐:
  • Boss your card around: Tell sections where to go with sections_order.
  • Double Trouble: In double column layout, assign sections to the left or right using sections_columns.
  • Give sections some personal space with custom top/bottom margins (section_styles).
• Text Appeal! ✨: Align your title (left, center, right), pick its size, and control text sizes on bars and icons. Readability FTW!
• Parlez-vous Français? (Localization Ready): We've added the plumbing for translations and some we supported in the past even some that were in PR limbo (thanks!).

✨ Polished Chrome & Engine Tweaks (Changes & Improvements)

• Total Rebuild (TypeScript Power!): We swapped the old JavaScript engine for a shiny TypeScript one. This means better code quality, fewer weird bugs, and makes it easier for us to add more cool stuff later without breaking things (as much 😉).
• Modern Factory: Built using up-to-date web development tools and practices.
• Neat & Tidy: Code is now organized logically, making it easier to maintain and improve.
• New UI Editor: The visual editor got a major makeover to handle all the new options. It's like upgrading from a basic radio to a full infotainment system. (Tabs might be different now, think "Settings", "Bars", "Icon Rows", "Layout", "Appearance").
• Performance Boost: Should run smoother thanks to the new structure.
• Clearer Controls: Configuration options are more obvious and give you finer control.
• Hide & Seek: Added show_* toggles for most core bits (battery, range, etc.) so you can easily hide what you don't need.
• To Unit or Not To Unit?: Added a global show_units toggle.

💥 Breaking Roadblocks (Compatibility Notice!)

• Your Old Configs = Junk: Seriously, v1.x configs WILL NOT WORK. You need to rebuild them using the v2.0 editor/YAML.
  • No more fixed entity slots. Use the bars array.
  • No more old icon grid. Use the icon_rows array.
  • Colors and other settings have likely changed names/locations.
• Custom CSS Detour: If you used card-mod to tweak the style, your selectors are probably broken. You'll need to inspect the new structure and update them. We now allow for a Global CSS area to overwrite styles within the card.
• Vehicle Type Removed: Electric/Fuel/Hybrid is now determined by the entities you assign to your bars, not a specific setting.

❤️ Fuel the Fun! (Support Development)

Like the card? Find it useful? Awesome! Building and maintaining this card takes a lot of caffeine and late nights. Your support helps fuel development, allowing us to keep improving the card, adding features, and squashing bugs to make it something everyone loves.

If you're feeling generous, you can find ways to contribute or send a tip via the links in the About tab within the card editor. Every little bit helps keep this project rolling! 🙏

We know migrating sucks, but v2.0 is a huge leap forward, making the card way more flexible and future-proof. Thanks for rolling with the changes, and enjoy the ride! 🎉