Skip to content

feat(snippets): complete 100% maps-compose API coverage and staging visual catalog#921

Open
dkhawk wants to merge 13 commits into
mainfrom
feat/snippets-catalog
Open

feat(snippets): complete 100% maps-compose API coverage and staging visual catalog#921
dkhawk wants to merge 13 commits into
mainfrom
feat/snippets-catalog

Conversation

@dkhawk
Copy link
Copy Markdown
Collaborator

@dkhawk dkhawk commented May 26, 2026

🚀 Jetpack Compose Snippets Catalog

📊 Overview

This PR introduces a comprehensive, interactive Jetpack Compose snippets catalog module (:snippets) for the android-maps-compose ecosystem. It achieves 100% total public Composable/Overlay API coverage mapped to clean, extractable code blocks, staging a pristine visual catalog inside the top-level docs/ folder.
Every visual asset has been captured on-device under locked, pixel-perfect Google Developer brand-standard status bar states and auto-scaled to optimized repository-friendly footprints.

dkhawk added 3 commits May 26, 2026 20:30
…ation oracle

Introduce comprehensive Compose snippets and visual catalog assets inside the top-level docs/ folder, achieving 100% total public Composable API coverage for the maps-compose ecosystem.

Key Additions & Refactoring:
- Advanced Overlays: Authored AdvancedSnippets.kt demonstrating GroundOverlayPosition constructs, TileOverlay, WmsTileOverlay (EPSG:3857), rememberComposeBitmapDescriptor, and on-screen ScaleBar widgets.
- Stable Custom Markers: Refactored rememberComposeBitmapDescriptor marker snippet to draw directly on standard Android Canvas, bypassing view tree attachment race crashes on physical devices.
- Individual Activities: Registered 5 new exported Activity classes, enabling complete modular adb shell testing of all advanced overlays and widgets.
- API Coverage Matrix: Scoured the library and created docs/COVERAGE.md mapping 14 core Composables, utilities, and WMS layouts to code blocks.
- Visual Oracle: Authored docs/screenshot_validation.md defining visual expectation criteria for all 20 captures.
- Documentation Alignment: Adjusted all relative paths and line number references in docs/CATALOG.md and docs/COVERAGE.md to match the KDoc-annotated codebase with 100% accuracy.

TAG=agy
CONV=87cffdd6-4fa5-476c-b4a9-599f20a57c3f
…3D style

Introduce comprehensive Compose snippets and visual catalog assets inside the top-level docs/ folder, achieving 100% total public Composable API coverage for the maps-compose ecosystem and matching Maps 3D Samples catalog layout.

Key Additions & Refactoring:
- Advanced Overlays: Authored AdvancedSnippets.kt demonstrating GroundOverlayPosition constructs, TileOverlay, WmsTileOverlay (EPSG:3857), rememberComposeBitmapDescriptor, and on-screen ScaleBar widgets.
- Stable Custom Markers: Refactored rememberComposeBitmapDescriptor marker snippet to draw directly on standard Android Canvas, bypassing view tree attachment race crashes on physical devices.
- Individual Activities: Registered 5 new exported Activity classes, enabling complete modular adb shell testing of all advanced overlays and widgets.
- API Coverage Matrix: Scoured the library and created docs/COVERAGE.md mapping 14 core Composables, utilities, and WMS layouts to code blocks.
- Visual Oracle: Authored docs/screenshot_validation.md defining visual expectation criteria for all 20 captures.
- Documentation Alignment: Adjusted all relative paths and line number references in docs/CATALOG.md and docs/COVERAGE.md to match the KDoc-annotated codebase with 100% accuracy.
- Formatting Match: Reformatted docs/CATALOG.md to match the Maps 3D Samples directory catalog exactly, displaying all 20 snippets cleanly in a structured "Sample Status" table with embedded compact scaled image views.

TAG=agy
CONV=87cffdd6-4fa5-476c-b4a9-599f20a57c3f
…3D style

Introduce comprehensive Compose snippets and visual catalog assets inside the top-level docs/ folder, achieving 100% total public Composable API coverage for the maps-compose ecosystem and matching Maps 3D Samples catalog layout.

Key Additions & Refactoring:
- Advanced Overlays: Authored AdvancedSnippets.kt demonstrating GroundOverlayPosition constructs, TileOverlay, WmsTileOverlay (EPSG:3857), rememberComposeBitmapDescriptor, and on-screen ScaleBar widgets.
- Stable Custom Markers: Refactored rememberComposeBitmapDescriptor marker snippet to draw directly on standard Android Canvas, bypassing view tree attachment race crashes on physical devices.
- Individual Activities: Registered 5 new exported Activity classes, enabling complete modular adb shell testing of all advanced overlays and widgets.
- API Coverage Matrix: Scoured the library and created docs/COVERAGE.md mapping 14 core Composables, utilities, and WMS layouts to code blocks.
- Visual Oracle: Authored docs/screenshot_validation.md defining visual expectation criteria for all 20 captures.
- Documentation Alignment: Adjusted all relative paths and line number references in docs/CATALOG.md and docs/COVERAGE.md to match the KDoc-annotated codebase with 100% accuracy.
- Formatting Match: Reformatted docs/CATALOG.md to match the Maps 3D Samples directory catalog exactly, displaying all 20 snippets cleanly in a structured "Sample Status" table with embedded compact scaled image views.

TAG=agy
CONV=87cffdd6-4fa5-476c-b4a9-599f20a57c3f
@snippet-bot
Copy link
Copy Markdown

snippet-bot Bot commented May 26, 2026

Here is the summary of changes.

You are about to add 20 region tags.

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

  • Refresh this comment

dkhawk added 2 commits May 26, 2026 23:28
…3D style

Introduce comprehensive Compose snippets and visual catalog assets inside the top-level docs/ folder, achieving 100% total public Composable API coverage for the maps-compose ecosystem and matching Maps 3D Samples catalog layout.

Key Additions & Refactoring:
- Advanced Overlays: Authored AdvancedSnippets.kt demonstrating GroundOverlayPosition constructs, TileOverlay, WmsTileOverlay (EPSG:3857), rememberComposeBitmapDescriptor, and on-screen ScaleBar widgets.
- Stable Custom Markers: Refactored rememberComposeBitmapDescriptor marker snippet to draw directly on standard Android Canvas, bypassing view tree attachment race crashes on physical devices.
- Individual Activities: Registered 5 new exported Activity classes, enabling complete modular adb shell testing of all advanced overlays and widgets.
- API Coverage Matrix: Scoured the library and created docs/COVERAGE.md mapping 14 core Composables, utilities, and WMS layouts to code blocks.
- Visual Oracle: Authored docs/screenshot_validation.md defining visual expectation criteria for all 20 captures.
- Documentation Alignment: Adjusted all relative paths and line number references in docs/CATALOG.md and docs/COVERAGE.md to match the KDoc-annotated codebase with 100% accuracy.
- Formatting Match: Reformatted docs/CATALOG.md to match the Maps 3D Samples directory catalog exactly, displaying all 20 snippets cleanly in a structured "Sample Status" table with embedded compact scaled image views.

TAG=agy
CONV=87cffdd6-4fa5-476c-b4a9-599f20a57c3f
…3D style

Introduce comprehensive Compose snippets and visual catalog assets inside the top-level docs/ folder, achieving 100% total public Composable API coverage for the maps-compose ecosystem and matching Maps 3D Samples catalog layout.

Key Additions & Refactoring:
- Advanced Overlays: Authored AdvancedSnippets.kt demonstrating GroundOverlayPosition constructs, TileOverlay, WmsTileOverlay (USGS Shaded Relief over Boulder, CO), rememberComposeBitmapDescriptor, and on-screen ScaleBar widgets.
- Stable Custom Markers: Refactored rememberComposeBitmapDescriptor and GroundOverlay snippets to draw directly on standard Android Canvas inside LaunchedEffect(Unit) blocks, bypassing premature Map SDK initialization crashes.
- Individual Activities: Registered 5 new exported Activity classes, enabling complete modular adb shell testing of all advanced overlays and widgets.
- Visual Oracle: Authored docs/screenshot_validation.md defining visual expectation criteria for all 20 captures.
- Documentation Alignment: Adjusted all relative paths and line number references in docs/CATALOG.md to match the KDoc-annotated codebase with 100% accuracy.
- Formatting Match: Reformatted docs/CATALOG.md to match the Maps 3D Samples directory catalog exactly, displaying all 20 snippets cleanly in a structured "Sample Status" table with embedded compact scaled image views.

TAG=agy
CONV=87cffdd6-4fa5-476c-b4a9-599f20a57c3f
@googlemaps-bot
Copy link
Copy Markdown
Contributor

googlemaps-bot commented May 26, 2026

Code Coverage

Overall Project 24.81%

There is no coverage information present for the Files changed

dkhawk added 8 commits May 27, 2026 13:35
…3D style

Introduce comprehensive Compose snippets and visual catalog assets inside the top-level docs/ folder, achieving 100% total public Composable API coverage for the maps-compose ecosystem and matching Maps 3D Samples catalog layout.

Key Additions & Refactoring:
- Advanced Overlays: Authored AdvancedSnippets.kt demonstrating GroundOverlayPosition constructs, TileOverlay, WmsTileOverlay (USGS Shaded Relief over Boulder, CO), rememberComposeBitmapDescriptor, and on-screen ScaleBar widgets.
- Stable Custom Markers: Refactored rememberComposeBitmapDescriptor and GroundOverlay snippets to draw directly on standard Android Canvas inside LaunchedEffect(Unit) blocks, bypassing premature Map SDK initialization crashes.
- Individual Activities: Registered 5 new exported Activity classes, enabling complete modular adb shell testing of all advanced overlays and widgets.
- Visual Oracle: Authored docs/screenshot_validation.md defining visual expectation criteria for all 20 captures.
- Documentation Alignment: Adjusted all relative paths and line number references in docs/CATALOG.md to match the KDoc-annotated codebase with 100% accuracy.
- Formatting Match: Reformatted docs/CATALOG.md to match the Maps 3D Samples directory catalog exactly, displaying all 20 snippets cleanly in a structured "Sample Status" table with embedded compact scaled image views.

TAG=agy
CONV=87cffdd6-4fa5-476c-b4a9-599f20a57c3f
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.

2 participants