feat: introduce URL-first Sparkling Router

[Huxpro]

Summary

Introduces URL-first declarative routing across Sparkling native containers, with a TanStack-compatible soft-navigation runtime and native hard-stack protocol.

Related issues

Standalone implementation based on the Sparkling Router RFC draft.

Changes

• add the router.stack command/event protocol, result correlation, and web fallback
• add sparkling-router with manifest resolution, CompositeHistory, GlobalStackMirror, hard-navigation hooks, and result routing
• add sparkling-router-plugin with _container partitioning, TanStack generation, multi-entry injection, serializable manifests, and ReactLynx aliases
• add iOS container registry, push/modal stack tracking, targeted close, prefetch TTL, reset/replace handling, and gesture convergence
• add Android activity-stack tracking, lifecycle/process restoration, launch cancellation, result routing, and protocol validation
• wire the new packages into CI, coverage, and release-version scripts

How to test

• pnpm --filter sparkling-navigation build && pnpm --filter sparkling-navigation test
• pnpm --filter sparkling-router build && pnpm --filter sparkling-router test
• pnpm --filter sparkling-router-plugin build && pnpm --filter sparkling-router-plugin test
• Android Gradle unit/compile checks when an Android SDK is available
• iOS playground build and native gesture/modal conformance checks on macOS

Checklist

• I read CONTRIBUTING.md.
• This is a standalone change; no related issue exists.
• I ran relevant checks.
• I updated docs/examples (the end-to-end demo remains follow-up work).
• I added/updated tests.

  

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
sparkling	Error		Jul 26, 2026 9:12am