feat(snippets): complete 100% maps-compose API coverage and staging visual catalog - #921
Draft
dkhawk wants to merge 17 commits into
Draft
feat(snippets): complete 100% maps-compose API coverage and staging visual catalog#921dkhawk wants to merge 17 commits into
dkhawk wants to merge 17 commits into
Conversation
…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
Contributor
Code Coverage
|
…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
…imate GIFs and H.264 MP4s
…oop and add high-quality GIF
…enerate custom config GIF
…r a compact layout
… composition tests
…otless formatting globally
![github-advanced-security[bot]](https://cdn.statically.io/img/avatars.githubusercontent.com/in/57789?s=60&v=4){kind=small}
| 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 |
…ra position assertions
…less-formatted source
dkhawk
marked this pull request as draft
August 25, 2026 17:00
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🚀 Jetpack Compose Snippets Catalog
📊 Overview
This PR introduces a comprehensive, interactive Jetpack Compose snippets catalog module (
:snippets) for theandroid-maps-composeecosystem. It achieves 100% total public Composable/Overlay API coverage mapped to clean, extractable code blocks, staging a pristine visual catalog inside the top-leveldocs/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.