[benforsrup]

Summary

What/Why?

• Refs React Native: optional hierarchical ordered-list numbering #1051. Add optional markdownStyle.list.numbering: 'flat' | 'hierarchical', default 'flat'.
• Render ancestor-qualified ordered markers (1.1., 1.2., 2.1.) on iOS and Android, reserving the complete marker width for wrapped lines.
• Reuse the current ordered-counter stack and scope snapshots; retain the marker-width and mixed-list fixes from fix: size ordered list markers to their widest number #1015 and fix(android): align mixed nested list indents with iOS #1023.
• Include nested and wrapped/non-default-start Storybook examples and style documentation. No table changes or generated build output.

Testing

• The 1.1.1 consumer prototype compiled and ran on iOS and Android; captures covered two ordered levels, parent advancement and long wrapped items.
• This port adapts that prototype to upstream's newer marker-width/context implementation. The exact port and its new examples have not been built, linted, type-checked or run in the upstream example app.
• Draft pending API feedback and upstream E2E/default-mode coverage, including deeper/mixed/task lists, non-default starts, RTL, font scaling and live streaming. Web/macOS parity is outside this draft's validation.

PR Checklist

• Code compiles and runs on iOS in the upstream example
• Code compiles and runs on Android in the upstream example
• Updated documentation/README if applicable
• Ran example app to verify changes
• E2E tests are passing
• Required E2E tests have been added (if applicable)

Compatibility Notes

• Existing consumers keep flat markers by default and need no migration.
• Opt in through markdownStyle.list.numbering; Markdown source/parser output is unchanged.