docs: record preview computation contracts

This commit is contained in:
que01 committed 2026-09-14 13:52:42 +08:00
1 parent 82846cdebc
commit 3d5cc2de6b
2 files changed
+20 -1

No files matched your search

+19
View File
@@ -497,3 +497,22 @@ published pavement region and avoid island edges/interiors. Failed candidate
paths remain diagnostic/deferred movements, never fake safe curves. Current
implementation explores a bounded set of cubic control lengths; it is not a
complete motion planner and does not prove vehicle swept-envelope clearance.
## Preview computation and bundled assets
When `resolveDirectEditConstraints()` receives `selection.type === 'cluster'`,
it may omit road, node-junction, and lane-maneuver handles that the selector
would discard. It must still solve the complete document before filtering the
manifest: saved constraints outside the selected handle family can affect the
compiled geometry. The scoped result must equal the unscoped resolution with
only the published handle array filtered.
The bundled `assets/lane-icons/manifest.json` may be cached in-process using its
file modification time and size as the invalidation key. Custom manifest paths
remain uncached because they are valid live test/config inputs. Caching must not
change compiled features or manifest validation errors.
Regression requirements: compare scoped and unscoped resolution plus compiled
layers for an empty document and a document containing mixed constraint kinds;
load the bundled manifest twice and verify the cached result; run the existing
preview/API and geometry suites after changes.