地图路线描绘

<!-- motion-registry-context:{"format":"1.0.0","recipe_id":"map.route-trace","recipe_version":"0.2.0","recipe_source":"recipes/map/route-trace/recipe.yaml"} -->
# Motion Registry Context

<!-- motion-registry-section:recipe-identity:start -->
## Recipe identity
- Recipe ID: map.route-trace
- Schema version: 0.2.0
- Recipe source: recipes/map/route-trace/recipe.yaml
<!-- motion-registry-section:recipe-identity:end -->

<!-- motion-registry-section:motion-intent:start -->
## Motion intent and scope
- Purpose (zh): 本地地图轮廓提供空间上下文，一条路线连接起点、途经点和终点。
- Purpose (en): A local map outline supplies spatial context while one route connects origin, waypoints, and destination.
- Scope: effect
- Complexity: intermediate
- Subjects: map, shape
- Intents: explain, demonstrate
- Use cases: knowledge-video, documentary, tutorial, presentation
- Recipe capabilities: local-map-outline, route-path, waypoint-markers, endpoint-focus
<!-- motion-registry-section:motion-intent:end -->

<!-- motion-registry-section:inputs:start -->
## Inputs
- origin_label: string (required; default=NORTH) — Label at the route origin.
- destination_label: string (required; default=SOUTH) — Label at the route destination.
- route_points: string (required; default=0.16,0.72|0.28,0.54|0.46,0.58|0.62,0.34|0.82,0.43) — Normalized route points encoded as x,y pairs separated by vertical bars.
- headline: string (required; default=Route intelligence) — Explanatory headline.
<!-- motion-registry-section:inputs:end -->

<!-- motion-registry-section:normalized-timeline:start -->
## Normalized motion timeline (0 to 1)
- 0.06–0.22 · map.fade · opacity.fade → map · parameters={"from":0,"to":1}
- 0.18–0.72 · route.draw · path.draw → route · parameters={"from":0,"to":1}
- 0.30–0.74 · markers.reveal · collection.reveal → markers · parameters={"order":"source","opacity_from":0,"opacity_to":1}
- 0.30–0.74 · markers.stagger · collection.stagger → markers · parameters={"order":"source","fraction":0.16}
- 0.70–0.86 · destination.settle · spring.settle → destination · parameters={"from":0.78,"to":1,"strength":"normal"}
- 0.88–1.00 · map.hold · state.hold → map · parameters={}
<!-- motion-registry-section:normalized-timeline:end -->

<!-- motion-registry-section:output-envelope:start -->
## Output envelope
- Aspect ratios: 16:9, 9:16, 1:1
- Duration: min 3s; preferred 3.8s; max 5s
<!-- motion-registry-section:output-envelope:end -->

<!-- motion-registry-section:acceptance:start -->
## Acceptance constraints
- local-context: The map outline is self-authored or locally licensed and never fetched during rendering.
- continuous-route: The route draws continuously from origin through waypoints to destination.
- endpoint-legible: Origin and destination labels remain visible without route or marker overlap.
- stable-hold: The final map, route, and markers remain still and readable.
<!-- motion-registry-section:acceptance:end -->

<!-- motion-registry-section:handoff-invariants:start -->
## Handoff invariants
- Preserve the subject, input meaning, event order, overlaps, final state, and approximate normalized timing.
- Keep the implementation deterministic and retain a readable, stable final hold.
- Treat the Recipe document as the source of truth; do not infer engine APIs in this shared core.
<!-- motion-registry-section:handoff-invariants:end -->