Skip to content

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

Draft
dkhawk wants to merge 17 commits into
mainfrom
feat/snippets-catalog
Draft

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

Conversation

@dkhawk

@dkhawk dkhawk commented May 26, 2026

Copy link
Copy Markdown
Collaborator

🚀 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.

@snippet-bot

snippet-bot Bot commented May 26, 2026 •

Copy link
Copy Markdown

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

@googlemaps-bot

googlemaps-bot commented May 26, 2026 •

Copy link
Copy Markdown
Contributor

Code Coverage

Overall Project 24.82% ❌

There is no coverage information present for the Files changed

val screenWidth = configuration.screenWidthDp.dp
val clusterManager = rememberClusterManager<MyItem>()
val configuration = LocalConfiguration.current
val screenHeight = configuration.screenHeightDp.dp
val clusterManager = rememberClusterManager<MyItem>()
val configuration = LocalConfiguration.current
val screenHeight = configuration.screenHeightDp.dp
val screenWidth = configuration.screenWidthDp.dp
@dkhawk
dkhawk marked this pull request as draft August 25, 2026 17:00
dkhawk added 17 commits October 1, 2026 14:29
…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
…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
…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
@dkhawk
dkhawk force-pushed the feat/snippets-catalog branch from ccac7d5 to caf3040 Compare October 1, 2026 21:07

This branch has not been deployed

No deployments
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.

3 participants