docs: record preview computation contracts
This commit is contained in:
1 parent
82846cdebc
commit
3d5cc2de6b
2 files changed
+20
-1
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user