How loadMapPackage reacts when a single protocol-backed source
binding fails to project / build a Honua source spec. Defaults to
"tolerant" because the entire point of mixed-protocol composition is
that one bad source should not break the rest of the map.
Per-source binding failures still surface loudly under "tolerant":
the runtime emits a { type: "source-error", sourceId, error }
event,
layers whose source references a failed source are dropped from
the composed style so MapLibre does not throw on a missing source.
"fail-fast" preserves the historical single-source behaviour: any
per-source binding failure rejects the load with
HonuaMapPackageError({ stage: "source-bind" }). Configuration-level
binding errors (unknown protocol, missing locator, duplicate id,
deferred workspace_artifact) raised by projectSourceBindings
always fail-fast under either policy — those are operator errors that
must be fixed.
How
loadMapPackagereacts when a single protocol-backed source binding fails to project / build a Honua source spec. Defaults to"tolerant"because the entire point of mixed-protocol composition is that one bad source should not break the rest of the map.Per-source binding failures still surface loudly under
"tolerant":{ type: "source-error", sourceId, error }event,source-bindspan,sourcereferences a failed source are dropped from the composed style so MapLibre does not throw on a missing source."fail-fast"preserves the historical single-source behaviour: any per-source binding failure rejects the load withHonuaMapPackageError({ stage: "source-bind" }). Configuration-level binding errors (unknown protocol, missing locator, duplicate id, deferredworkspace_artifact) raised byprojectSourceBindingsalways fail-fast under either policy — those are operator errors that must be fixed.