# WhaleTown Mall UI Assets

Generated with Novamailio for the final panel-style mall system.

Current implementation focus: UI skin assets. Product/item art is optional
placeholder material and can be replaced when final products are defined.

## Folders

- `icons/`: category navigation icons.
- `items/`: product card and product detail item art.
- `branding/`: shared mall badge, currency, locked, and empty-state assets.
- `skin/`: mall UI control skins such as panels, cards, buttons, dialogs, and toast frames.
- `skin/clean/`: cleaner scalable control skins recommended for first implementation.
- `preview/`: QA contact sheets for reviewing the generated asset pack.

## UI Skin Assets

Recommended implementation set:

- `skin/clean/clean_panel_main_frame.png`: main mall panel frame.
- `skin/clean/clean_header_bar.png`: top header bar.
- `skin/clean/clean_card_normal.png`: normal product card background.
- `skin/clean/clean_card_selected.png`: selected product card background.
- `skin/clean/clean_primary_button.png`: primary purchase button background.
- `skin/clean/clean_secondary_button.png`: secondary/preview button background.
- `skin/clean/clean_dialog_frame.png`: purchase confirmation dialog frame.
- `skin/clean/clean_toast_frame.png`: toast notification frame.

Decorative alternatives:

- `skin/panel_main_frame.png`
- `skin/panel_header_bar.png`
- `skin/panel_detail_frame.png`
- `skin/panel_grid_surface.png`
- `skin/button_category_normal.png`
- `skin/button_category_selected.png`
- `skin/card_item_normal.png`
- `skin/card_item_selected.png`
- `skin/card_item_locked_overlay.png`
- `skin/button_primary_normal.png`
- `skin/button_primary_disabled.png`
- `skin/button_close_square.png`
- `skin/capsule_currency_bar.png`
- `skin/dialog_confirm_frame.png`
- `skin/toast_info_frame.png`
- `skin/tag_status_pill.png`
- `skin/scrollbar_thumb.png`
- `skin/bottom_nav_bar.png`

## Category Icons

- `icons/category_recommended.png`: 推荐
- `icons/category_outfit.png`: 装扮
- `icons/category_items.png`: 道具
- `icons/category_companion.png`: 伙伴
- `icons/category_space.png`: 空间装饰
- `icons/category_limited.png`: 限时活动

## Item Icons

- `items/item_whale_avatar_frame.png`: 小鲸头像框
- `items/item_blue_commuter_outfit.png`: 蓝白通勤服
- `items/item_data_apprentice_title.png`: 数据学徒称号
- `items/item_task_refresh_ticket.png`: 任务刷新券
- `items/item_mini_whale_companion.png`: 小鲸伙伴
- `items/item_coastal_room_poster.png`: 海岸小镇海报
- `items/item_mall_discount_coupon.png`: 商城折扣券
- `items/item_whale_coin_pack.png`: 鲸币礼包

## Branding And States

- `branding/branding_mall_badge.png`: 商城徽章
- `branding/branding_whale_coin.png`: 鲸币图标
- `branding/branding_locked_badge.png`: 未开放/锁定状态
- `branding/branding_empty_state_box.png`: 空状态

## Notes

- Images contain no baked-in Chinese text; labels should be rendered by Godot UI.
- Final assets are transparent PNGs prepared for `TextureRect`.
- `mall_assets_manifest.json` records ids, paths, types, and image sizes.
- Source Novamailio outputs and BiRefNet QA samples are under `output/novamailio-imagegen/mall_assets/`.