Skip to content

docs: refresh README progress section#17

Merged
jonathanpeppers merged 1 commit into
mainfrom
jonathanpeppers/readme-progress-update
Jun 3, 2026
Merged

docs: refresh README progress section#17
jonathanpeppers merged 1 commit into
mainfrom
jonathanpeppers/readme-progress-update

Conversation

@jonathanpeppers

Copy link
Copy Markdown
Owner

Brings the README in line with where the facade actually is today. The Status section had drifted: it still talked about the in-repo ComposeNet.Bindings.* projects (deleted when we moved to the official Xamarin.AndroidX.Compose.* 1.11.1.1 / Material3 1.4.0.x NuGets), pointed at a ComposeApi.cs that's now ComposeBridges.cs, and only mentioned 4 composables when we now wrap 27.

Highlights of the rewrite:

  • New "Composables shipped today" table covering buttons, text fields, chips, navigation bar/rail, sheets, date/time pickers, dialogs, and tooltip.
  • Source-generator section now documents both the generic ComposeDefaults<T> form and the declarative ComposeDefaults(...) form (with the !-prefix and per-call slot-toggle conventions). Drops the stale claim that ButtonDefault/TextDefault are hand-rolled — they're generated declaratively now.
  • JNI-bridge paragraph renamed to ComposeBridges.cs and calls out the try/finally + GC.KeepAlive pattern; links [generator] Phase 2: Kotlin @JvmInline value class projection dotnet/java-interop#1440 as the deletion plan.
  • "What's missing" updated for the now-working Remember(() => …) (only keyed/nested remember is still Tier 2).
  • Known issues: drop the obsolete Material3 XA4215 stub-collision item and the "no remember from C#" item; expand the inline-class mangling list with the new manglings we encountered (AlertDialog-Oix01E0, NavigationBar-HsRjFd4, FloatingActionButton-X-z6DiA, ModalBottomSheet-dYc4hso).

Docs only — no code or tests touched.

- Status section: drop stale references to the deleted in-repo `ComposeNet.Bindings.*` projects; the facade now references the official `Xamarin.AndroidX.Compose.*` 1.11.1.1 / Material3 1.4.0.x NuGets directly.

- Add a `Composables shipped today` table covering all 27 wrapped composables (buttons, text fields, chips, navigation bar/rail, sheets, pickers, dialogs, tooltip).

- Source-generator section: document both the generic `ComposeDefaults<T>` and the declarative `ComposeDefaults(...)` forms, with the `!`-prefix and slot-toggle conventions. Removes the inaccurate claim that `ButtonDefault` / `TextDefault` are hand-rolled.

- JNI bridges: rename to `ComposeBridges.cs` and call out the `try` / `finally` + `GC.KeepAlive` pattern.

- Known issues: drop the obsolete Material3 XA4215 stub-collision item and the `no remember from C#` item; expand the inline-class mangling list.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings June 3, 2026 19:30
@jonathanpeppers jonathanpeppers merged commit 08080d0 into main Jun 3, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the repository README to reflect the current state of the ComposeNet.Compose facade and its supporting infrastructure (official Xamarin.AndroidX.Compose.* NuGets, generated $default enums, and ComposeBridges.cs JNI bridging), removing stale references to deleted in-repo bindings and outdated status details.

Changes:

  • Refreshes the Status/Progress sections to describe the current package sourcing and sample behavior.
  • Adds/updates documentation for the shipped composables set and the $default bitmask source generator’s two supported declaration forms.
  • Updates the JNI bridge and “Known issues / What’s missing” descriptions to align with today’s implementation details and upstream tracking.

Comment thread README.md
Comment on lines 203 to +204
3 UI**, and the counter button is **interactive** (tapping increments
`MutableState<Int>` and recomposes the `Text`).
`MutableNumberState<int>` and recomposes the `Text`).
Comment thread README.md
Comment on lines +411 to +414
Optional slot lambdas the caller toggles per-call (e.g. `AlertDialog`'s
`dismissButton`/`icon`/`title`/`text`, `NavigationBarItem.label`) stay
as enum members so the call site can OR them in. Call sites collapse to
`(int)ButtonDefault.All`.
@jonathanpeppers jonathanpeppers deleted the jonathanpeppers/readme-progress-update branch June 4, 2026 16:51
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