feat(checkout): pass the cart's shipment options to the delivery options widget

[FreekVR]

Adds the cart's calculated shipment options to the checkout context, and fixes the age check (18+) rules on the carrier settings screen.

The checkout context gets a new optional cartShipmentOptions key (a sibling of config): per carrier, the widget's camelCase option name → boolean, calculated by running the cart through the same pipeline an order export uses. The delivery options widget shows those options (like the ones 18+ requires) as checked and locked for the consumer; without the key the widget behaves as before. js-pdk forwards the key to the widget in myparcelnl/js-pdk#381.

On the carrier settings screen the 18+ rules now lock signature and only recipient only when 18+ is actually on — the lock previously also matched "inherit". Test fixtures now carry the real capability rules for age verification (requires signature and only recipient, excludes receipt code), with regression tests pinning the export path.

Merge order for INT-1596:

1. feat(checkout): lock shipment options the cart already decided on delivery-options#480 — its release adds cartShipmentOptions to the widget input.
2. fix(admin): enforce carrier rules on shipment options in settings and orders js-pdk#381 — bump @myparcel-dev/delivery-options there afterwards to turn its typecheck green.
3. This PR — independent, can merge any time.

Fixes INT-1596
Subtask: INT-1732

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR extends the checkout context with cart-calculated shipment options per carrier (so the delivery options widget can display/lock merchant-forced options like 18+) and fixes the age-check (18+) locking logic on the carrier settings UI to only apply when age check is explicitly enabled.

Changes:

• Add DeliveryOptionsServiceInterface::createCartShipmentOptions() and compute per-carrier shipment options by running a cart-derived synthetic order through the export calculation pipeline.
• Add CheckoutContext::cartShipmentOptions and convert calculated ShipmentOptions tri-state values into widget-format booleans at the context boundary.
• Fix carrier settings UI behavior so signature/only-recipient are locked only when age check is explicitly ENABLED, and update/add regression tests + fixtures to reflect real capability requires/excludes rules.

Reviewed changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/Unit/Frontend/View/CarrierSettingsItemViewTest.php	Adds regression coverage for strict tri-state operations and correct locking behavior for age check.
tests/Unit/App/Order/Service/PdkOrderOptionsServiceTest.php	Adds regression test ensuring capability “requires/excludes” are enforced when age check originates from carrier settings.
tests/Unit/App/DeliveryOptions/Service/DeliveryOptionsServiceCartShipmentOptionsTest.php	New tests covering per-carrier cart shipment-options calculation and exposure through checkout context as widget booleans.
tests/Unit/App/Action/Backend/Order/ExportOrderActionTest.php	Strengthens export assertions for age check cascading behavior.
tests/SdkApi/Response/ExampleContractDefinitionsResponse.php	Documents API asymmetry: requires/excludes relations live on capabilities, not contract definitions.
tests/Bootstrap/MockCarrierCapabilitiesRepository.php	Updates permissive capabilities fixture with real age-verification requires/excludes relations.
tests/snapshots/SettingsViewTest__it_gets_settings_view_with_data_set_carrier_settings__1.json	Snapshot update reflecting strict $eq conditions for read-only behavior.
tests/snapshots/FrontendRenderServiceTest__it_renders_component_with_data_set_plugin_settings__1.json	Snapshot update reflecting strict $eq conditions for read-only behavior.
tests/snapshots/FrontendRenderServiceTest__it_renders_component_with_data_set_delivery_options__1.json	Snapshot update adding cartShipmentOptions to checkout context output.
tests/snapshots/ContextServiceTest__it_gets_context_data_with_data_set_delivery_options_config__1.json	Snapshot update adding cartShipmentOptions to checkout context output.
src/Shipment/Model/ShipmentOptions.php	Adds ShipmentOptions::toBooleanOptions() to convert strict tri-state options to widget booleans.
src/Shipment/Collection/ShipmentOptionsCollection.php	Introduces a typed collection for ShipmentOptions, used as return type for cart shipment options per carrier.
src/Frontend/View/CarrierSettingsItemView.php	Fixes age-check dependent locking to only apply when age check is explicitly enabled.
src/Context/Model/CheckoutContext.php	Adds cartShipmentOptions to the checkout context and populates it from the cart calculation pipeline.
src/App/DeliveryOptions/Service/DeliveryOptionsService.php	Implements cart shipment option calculation per carrier via synthetic order + export pipeline.
src/App/DeliveryOptions/Contract/DeliveryOptionsServiceInterface.php	Adds new createCartShipmentOptions() contract method.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

❌ Patch coverage is 86.56716% with 9 lines in your changes missing coverage. Please review.
✅ Project coverage is 94.25%. Comparing base (0a13274) to head (6538122).

Files with missing lines	Patch %	Lines
...DeliveryOptions/Service/DeliveryOptionsService.php	79.41%	7 Missing ⚠️
.../Carrier/Service/CapabilitiesValidationService.php	75.00%	1 Missing ⚠️
...tings/Repository/AbstractPdkSettingsRepository.php	85.71%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##               main     #510      +/-   ##
============================================
- Coverage     94.33%   94.25%   -0.08%     
- Complexity     2414     2434      +20     
============================================
  Files           352      352              
  Lines          7726     7784      +58     
============================================
+ Hits           7288     7337      +49     
- Misses          438      447       +9     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[NabDevs]

1 thing to check, looks good otherwise.