adp-web-components 0.3.20 → 0.4.0

package/dist/types/components.d.ts

@@ -23,13 +23,13 @@ import { ActiveElement } from "./components/part-lookup/part-lookup";
 import { AccordionItem } from "./components/components/shift-accordion";
 import { FormSelectItem as FormSelectItem1 } from "./components";
 import { VehicleLookupDTO } from "./global/types/generated/vehicle-lookup/vehicle-lookup-dto";
-import { VehicleLookupMock } from "./features/vehicle-lookup-component/index";
+import { RequestHeadersProvider, VehicleLookupMock } from "./features/vehicle-lookup-component/index";
 import { VehicleLookupMock as VehicleLookupMock1 } from "./features/vehicle-lookup-component/types";
 import { VehicleServiceItemDTO } from "./global/types/generated/vehicle-lookup/vehicle-service-item-dto";
 import { ClaimFormType } from "./locales/vehicleLookup/claimableItems/type";
 import { ItemClaimDTO } from "./global/types/generated/vehicle-lookup/item-claim-dto";
 import { ActiveElement as ActiveElement1 } from "./components/vehicle-lookup/vehicle-lookup";
-import { VehicleWarrantyDetails } from "./components/vehicle-lookup/vehicle-warranty-details";
+import { VehicleSsc } from "./components/vehicle-lookup/vehicle-ssc";
 import { vehicleQuotationElementNames } from "./components/forms/vehicle-quotation/element-mapper";
 export { BranchSlotDay } from "./components/form-elements/branch-slot-dropdown";
 export { BranchDateDropdownCopy, BranchDateStep } from "./components/form-elements/branch-date-dropdown";
@@ -49,13 +49,13 @@ export { ActiveElement } from "./components/part-lookup/part-lookup";
 export { AccordionItem } from "./components/components/shift-accordion";
 export { FormSelectItem as FormSelectItem1 } from "./components";
 export { VehicleLookupDTO } from "./global/types/generated/vehicle-lookup/vehicle-lookup-dto";
-export { VehicleLookupMock } from "./features/vehicle-lookup-component/index";
+export { RequestHeadersProvider, VehicleLookupMock } from "./features/vehicle-lookup-component/index";
 export { VehicleLookupMock as VehicleLookupMock1 } from "./features/vehicle-lookup-component/types";
 export { VehicleServiceItemDTO } from "./global/types/generated/vehicle-lookup/vehicle-service-item-dto";
 export { ClaimFormType } from "./locales/vehicleLookup/claimableItems/type";
 export { ItemClaimDTO } from "./global/types/generated/vehicle-lookup/item-claim-dto";
 export { ActiveElement as ActiveElement1 } from "./components/vehicle-lookup/vehicle-lookup";
-export { VehicleWarrantyDetails } from "./components/vehicle-lookup/vehicle-warranty-details";
+export { VehicleSsc } from "./components/vehicle-lookup/vehicle-ssc";
 export { vehicleQuotationElementNames } from "./components/forms/vehicle-quotation/element-mapper";
 export namespace Components {
     /**
@@ -1314,6 +1314,7 @@ export namespace Components {
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         "fetchVin": (newData: VehicleLookupDTO | string, headers?: any) => Promise<void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers": object;
@@ -1335,6 +1336,11 @@ export namespace Components {
     interface VehicleClaimableItems {
         "activate"?: (vehicleInformation: VehicleLookupDTO) => void;
         "baseUrl": string;
+        /**
+          * Name of a [JSInvokable] method on the Blazor reference that answers with the current headers.
+          * @default ''
+         */
+        "blazorRequestHeadersProvider": string;
         "claim": (item: VehicleServiceItemDTO) => Promise<void>;
         /**
           * @default 'api/vehicle/swift-claim'
@@ -1352,6 +1358,7 @@ export namespace Components {
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         "fetchVin": (newData: VehicleLookupDTO | string, headers?: any) => Promise<void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers": object;
@@ -1372,6 +1379,10 @@ export namespace Components {
           * @default ''
          */
         "queryString": string;
+        /**
+          * Asked for the current headers before every request this component makes itself (trace, claim); lets a host refresh its token on demand.
+         */
+        "requestHeadersProvider"?: RequestHeadersProvider;
         "setBlazorRef": (newBlazorRef: DotNetObjectReference) => Promise<void>;
         "setErrorMessage": (message: ErrorKeys) => Promise<void>;
         "setMockData": (newMockData: VehicleLookupMock) => Promise<void>;
@@ -1424,6 +1435,11 @@ export namespace Components {
           * @default ''
          */
         "blazorOnLoadingStateChange": string;
+        /**
+          * Name of a [JSInvokable] method on the Blazor reference that answers with the current request headers.
+          * @default ''
+         */
+        "blazorRequestHeadersProvider": string;
         "childrenProps"?: string | object;
         /**
           * @default false
@@ -1459,11 +1475,12 @@ export namespace Components {
          */
         "queryString": string;
         /**
-          * @default false
+          * Asked for the current request headers before every request a child makes on its own — a trace, a claim, the unauthorized campaign lookup — so a host can refresh its token on demand instead of the children reusing the headers captured at the last search.
          */
-        "separateSsc": boolean;
+        "requestHeadersProvider"?: RequestHeadersProvider;
         "setBlazorRef": (newBlazorRef: DotNetObjectReference) => Promise<void>;
         /**
+          * Appended to the SSC tab's own lookup request only — e.g. a logging flag — so that only a search made from the SSC tab counts as a campaign check. A search from any other tab leaves the SSC tab in its "check required" state, which names the VIN and offers to run the check itself. Never joins the panel's trace request: a trace re-reads a lookup that was already logged.
           * @default ''
          */
         "sscQueryString": string;
@@ -1481,6 +1498,7 @@ export namespace Components {
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         "fetchVin": (newData: VehicleLookupDTO | string, headers?: any) => Promise<void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers": object;
@@ -1543,6 +1561,7 @@ export namespace Components {
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         "fetchVin": (newData: VehicleLookupDTO | string, headers?: any) => Promise<void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers": object;
@@ -1578,6 +1597,7 @@ export namespace Components {
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         "fetchVin": (newData: VehicleLookupDTO | string, headers?: any) => Promise<void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers": object;
@@ -1609,6 +1629,7 @@ export namespace Components {
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         "fetchVin": (newData: VehicleLookupDTO | string, headers?: any) => Promise<void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers": object;
@@ -1627,8 +1648,37 @@ export namespace Components {
         "setErrorMessage": (message: ErrorKeys) => Promise<void>;
         "setMockData": (newMockData: VehicleLookupMock) => Promise<void>;
     }
-    interface VehicleWarrantyDetails {
+    /**
+     * The Special Service Campaigns (safety recalls) affecting a vehicle, and nothing else: warranty
+     * coverage lives in <vehicle-warranty-timeline>. Replaces the campaign half of the retired
+     * <vehicle-warranty-details>.
+     * A vehicle is on exactly one of two paths, and the panel must never mix them (the rule is spelled
+     * out on `panelVerdict` in ./components/SscCampaigns.tsx and in
+     * .shift/repos/adp/web-components/vehicle-lookup-invariants.md):
+     *  - authorized (in the distributor's records): the campaign list is the verdict;
+     *  - unauthorized: the distributor has no records, so the only verdict is the manufacturer's
+     *    answer to the reCAPTCHA-gated check — a yes/no, no list. Until it arrives the panel says the
+     *    vehicle is not in the records and asserts nothing else.
+     * A third state is neither: a wrapper that only counts the SSC tab's own request as a campaign
+     * check (`sscQueryString`) tells this panel through `skipLookup` that a vehicle was looked up
+     * without it. The panel then says the check was not run and offers to run it, rather than sitting
+     * blank next to a VIN as if the vehicle had no campaigns.
+     * With `show-trace`, every campaign row can open the evidence behind its repair status: the labor
+     * codes accepted for the campaign, every warranty claim on the vehicle with how it was judged, and
+     * the service-history lines that matched. The trace is fetched on first use with `?trace=ssc`, so
+     * the ordinary lookup response stays small and the host can gate the detail behind a permission.
+     * Every state change is a movement (lookup-motion.css): the outgoing content stays rendered while
+     * the body shuts over it, and the incoming content is swapped in only while the body is shut. The
+     * shared lookup helper waits a second before it asks the server, which is what guarantees the body
+     * has settled shut before a response can land.
+     */
+    interface VehicleSsc {
         "baseUrl": string;
+        /**
+          * Name of a [JSInvokable] method on the Blazor reference that answers with the current headers.
+          * @default ''
+         */
+        "blazorRequestHeadersProvider": string;
         /**
           * @default null
          */
@@ -1641,6 +1691,9 @@ export namespace Components {
           * @default null
          */
         "cityIntegrationId"?: string;
+        /**
+          * Back to "no vehicle": the body shuts over what it holds, then the panel is emptied unseen.
+         */
         "clearData": () => Promise<void>;
         /**
           * @default null
@@ -1681,6 +1734,7 @@ export namespace Components {
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         "fetchVin": (newData: VehicleLookupDTO | string, headers?: any) => Promise<void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers": object;
@@ -1692,6 +1746,12 @@ export namespace Components {
         "loadedResponse"?: BlazorInvokableFunction<(response: VehicleLookupDTO) => void>;
         "loadingStateChange"?: BlazorInvokableFunction<(isLoading: boolean) => void>;
         /**
+          * Appended to the campaign lookup request only, never to the trace request. A wrapper passes its `sscQueryString` — typically a lookup-logging flag — here rather than into `queryString`, so opening a campaign's evidence (a re-read of a lookup that was already logged) is never counted as another lookup. The host's endpoint must refuse to log traced requests as well.
+          * @default ''
+         */
+        "lookupQueryString": string;
+        /**
+          * Renders a click-to-pass stand-in for the reCAPTCHA widget. Implied by `isDev`; the real widget is only ever used in production mode.
           * @default false
          */
         "mockRecaptcha": boolean;
@@ -1703,17 +1763,22 @@ export namespace Components {
           * @default ''
          */
         "recaptchaKey": string;
+        /**
+          * Asked for the current headers before every request this component makes itself; lets a host refresh its token on demand.
+         */
+        "requestHeadersProvider"?: RequestHeadersProvider;
         "setBlazorRef": (newBlazorRef: DotNetObjectReference) => Promise<void>;
         "setErrorMessage": (message: ErrorKeys) => Promise<void>;
         "setMockData": (newMockData: VehicleLookupMock) => Promise<void>;
         /**
+          * Shows a per-campaign "why this status?" control. The host gates it on its own permission check; the trace lists claim and invoice details.
           * @default false
          */
-        "showSsc": boolean;
+        "showTrace": boolean;
         /**
-          * @default false
+          * The other panels were given a vehicle but this one's own lookup was not run for it — a wrapper with `sscQueryString` only counts the SSC tab's own request as a campaign check. The panel says so and offers to run the check itself; the VIN is kept for that.
          */
-        "showWarranty": boolean;
+        "skipLookup": (vin: string) => Promise<void>;
         /**
           * @default ''
          */
@@ -1731,10 +1796,9 @@ export namespace Components {
     /**
      * Warranty coverage as a single dated rail: the standard warranty followed by every
      * extended coverage in sequence.
-     * Deliberately separate from `vehicle-warranty-details` rather than a mode of it. This
-     * panel shows warranty and nothing else — no campaign table, no reCAPTCHA, no unauthorized
-     * campaign lookup — so hosts adopt it by pointing their warranty tab at this tag and can
-     * keep the original panel untouched for as long as they like.
+     * This panel shows warranty and nothing else — no campaign table, no reCAPTCHA, no
+     * unauthorized campaign lookup; those belong to `vehicle-ssc`. Hosts point their warranty
+     * tab at this tag and their campaign tab at that one.
      */
     interface VehicleWarrantyTimeline {
         "baseUrl": string;
@@ -1750,6 +1814,7 @@ export namespace Components {
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         "fetchVin": (newData: VehicleLookupDTO | string, headers?: any) => Promise<void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers": object;
@@ -2218,19 +2283,42 @@ declare global {
         prototype: HTMLVehicleSpecificationElement;
         new (): HTMLVehicleSpecificationElement;
     };
-    interface HTMLVehicleWarrantyDetailsElement extends Components.VehicleWarrantyDetails, HTMLStencilElement {
+    /**
+     * The Special Service Campaigns (safety recalls) affecting a vehicle, and nothing else: warranty
+     * coverage lives in <vehicle-warranty-timeline>. Replaces the campaign half of the retired
+     * <vehicle-warranty-details>.
+     * A vehicle is on exactly one of two paths, and the panel must never mix them (the rule is spelled
+     * out on `panelVerdict` in ./components/SscCampaigns.tsx and in
+     * .shift/repos/adp/web-components/vehicle-lookup-invariants.md):
+     *  - authorized (in the distributor's records): the campaign list is the verdict;
+     *  - unauthorized: the distributor has no records, so the only verdict is the manufacturer's
+     *    answer to the reCAPTCHA-gated check — a yes/no, no list. Until it arrives the panel says the
+     *    vehicle is not in the records and asserts nothing else.
+     * A third state is neither: a wrapper that only counts the SSC tab's own request as a campaign
+     * check (`sscQueryString`) tells this panel through `skipLookup` that a vehicle was looked up
+     * without it. The panel then says the check was not run and offers to run it, rather than sitting
+     * blank next to a VIN as if the vehicle had no campaigns.
+     * With `show-trace`, every campaign row can open the evidence behind its repair status: the labor
+     * codes accepted for the campaign, every warranty claim on the vehicle with how it was judged, and
+     * the service-history lines that matched. The trace is fetched on first use with `?trace=ssc`, so
+     * the ordinary lookup response stays small and the host can gate the detail behind a permission.
+     * Every state change is a movement (lookup-motion.css): the outgoing content stays rendered while
+     * the body shuts over it, and the incoming content is swapped in only while the body is shut. The
+     * shared lookup helper waits a second before it asks the server, which is what guarantees the body
+     * has settled shut before a response can land.
+     */
+    interface HTMLVehicleSscElement extends Components.VehicleSsc, HTMLStencilElement {
     }
-    var HTMLVehicleWarrantyDetailsElement: {
-        prototype: HTMLVehicleWarrantyDetailsElement;
-        new (): HTMLVehicleWarrantyDetailsElement;
+    var HTMLVehicleSscElement: {
+        prototype: HTMLVehicleSscElement;
+        new (): HTMLVehicleSscElement;
     };
     /**
      * Warranty coverage as a single dated rail: the standard warranty followed by every
      * extended coverage in sequence.
-     * Deliberately separate from `vehicle-warranty-details` rather than a mode of it. This
-     * panel shows warranty and nothing else — no campaign table, no reCAPTCHA, no unauthorized
-     * campaign lookup — so hosts adopt it by pointing their warranty tab at this tag and can
-     * keep the original panel untouched for as long as they like.
+     * This panel shows warranty and nothing else — no campaign table, no reCAPTCHA, no
+     * unauthorized campaign lookup; those belong to `vehicle-ssc`. Hosts point their warranty
+     * tab at this tag and their campaign tab at that one.
      */
     interface HTMLVehicleWarrantyTimelineElement extends Components.VehicleWarrantyTimeline, HTMLStencilElement {
     }
@@ -2300,7 +2388,7 @@ declare global {
         "vehicle-sale-information": HTMLVehicleSaleInformationElement;
         "vehicle-service-history": HTMLVehicleServiceHistoryElement;
         "vehicle-specification": HTMLVehicleSpecificationElement;
-        "vehicle-warranty-details": HTMLVehicleWarrantyDetailsElement;
+        "vehicle-ssc": HTMLVehicleSscElement;
         "vehicle-warranty-timeline": HTMLVehicleWarrantyTimelineElement;
         "vin-extractor": HTMLVinExtractorElement;
     }
@@ -3520,6 +3608,7 @@ declare namespace LocalJSX {
         "disableVinValidation"?: boolean;
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers"?: object;
@@ -3538,6 +3627,11 @@ declare namespace LocalJSX {
     interface VehicleClaimableItems {
         "activate"?: (vehicleInformation: VehicleLookupDTO) => void;
         "baseUrl"?: string;
+        /**
+          * Name of a [JSInvokable] method on the Blazor reference that answers with the current headers.
+          * @default ''
+         */
+        "blazorRequestHeadersProvider"?: string;
         /**
           * @default 'api/vehicle/swift-claim'
          */
@@ -3552,6 +3646,7 @@ declare namespace LocalJSX {
         "disableVinValidation"?: boolean;
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers"?: object;
@@ -3571,6 +3666,10 @@ declare namespace LocalJSX {
           * @default ''
          */
         "queryString"?: string;
+        /**
+          * Asked for the current headers before every request this component makes itself (trace, claim); lets a host refresh its token on demand.
+         */
+        "requestHeadersProvider"?: RequestHeadersProvider;
         /**
           * @default false
          */
@@ -3613,6 +3712,11 @@ declare namespace LocalJSX {
           * @default ''
          */
         "blazorOnLoadingStateChange"?: string;
+        /**
+          * Name of a [JSInvokable] method on the Blazor reference that answers with the current request headers.
+          * @default ''
+         */
+        "blazorRequestHeadersProvider"?: string;
         "childrenProps"?: string | object;
         /**
           * @default false
@@ -3646,10 +3750,11 @@ declare namespace LocalJSX {
          */
         "queryString"?: string;
         /**
-          * @default false
+          * Asked for the current request headers before every request a child makes on its own — a trace, a claim, the unauthorized campaign lookup — so a host can refresh its token on demand instead of the children reusing the headers captured at the last search.
          */
-        "separateSsc"?: boolean;
+        "requestHeadersProvider"?: RequestHeadersProvider;
         /**
+          * Appended to the SSC tab's own lookup request only — e.g. a logging flag — so that only a search made from the SSC tab counts as a campaign check. A search from any other tab leaves the SSC tab in its "check required" state, which names the VIN and offers to run the check itself. Never joins the panel's trace request: a trace re-reads a lookup that was already logged.
           * @default ''
          */
         "sscQueryString"?: string;
@@ -3666,6 +3771,7 @@ declare namespace LocalJSX {
         "disableVinValidation"?: boolean;
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers"?: object;
@@ -3722,6 +3828,7 @@ declare namespace LocalJSX {
         "disableVinValidation"?: boolean;
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers"?: object;
@@ -3753,6 +3860,7 @@ declare namespace LocalJSX {
         "disableVinValidation"?: boolean;
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers"?: object;
@@ -3780,6 +3888,7 @@ declare namespace LocalJSX {
         "disableVinValidation"?: boolean;
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers"?: object;
@@ -3795,8 +3904,37 @@ declare namespace LocalJSX {
          */
         "queryString"?: string;
     }
-    interface VehicleWarrantyDetails {
+    /**
+     * The Special Service Campaigns (safety recalls) affecting a vehicle, and nothing else: warranty
+     * coverage lives in <vehicle-warranty-timeline>. Replaces the campaign half of the retired
+     * <vehicle-warranty-details>.
+     * A vehicle is on exactly one of two paths, and the panel must never mix them (the rule is spelled
+     * out on `panelVerdict` in ./components/SscCampaigns.tsx and in
+     * .shift/repos/adp/web-components/vehicle-lookup-invariants.md):
+     *  - authorized (in the distributor's records): the campaign list is the verdict;
+     *  - unauthorized: the distributor has no records, so the only verdict is the manufacturer's
+     *    answer to the reCAPTCHA-gated check — a yes/no, no list. Until it arrives the panel says the
+     *    vehicle is not in the records and asserts nothing else.
+     * A third state is neither: a wrapper that only counts the SSC tab's own request as a campaign
+     * check (`sscQueryString`) tells this panel through `skipLookup` that a vehicle was looked up
+     * without it. The panel then says the check was not run and offers to run it, rather than sitting
+     * blank next to a VIN as if the vehicle had no campaigns.
+     * With `show-trace`, every campaign row can open the evidence behind its repair status: the labor
+     * codes accepted for the campaign, every warranty claim on the vehicle with how it was judged, and
+     * the service-history lines that matched. The trace is fetched on first use with `?trace=ssc`, so
+     * the ordinary lookup response stays small and the host can gate the detail behind a permission.
+     * Every state change is a movement (lookup-motion.css): the outgoing content stays rendered while
+     * the body shuts over it, and the incoming content is swapped in only while the body is shut. The
+     * shared lookup helper waits a second before it asks the server, which is what guarantees the body
+     * has settled shut before a response can land.
+     */
+    interface VehicleSsc {
         "baseUrl"?: string;
+        /**
+          * Name of a [JSInvokable] method on the Blazor reference that answers with the current headers.
+          * @default ''
+         */
+        "blazorRequestHeadersProvider"?: string;
         /**
           * @default null
          */
@@ -3847,6 +3985,7 @@ declare namespace LocalJSX {
         "disableVinValidation"?: boolean;
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers"?: object;
@@ -3858,6 +3997,12 @@ declare namespace LocalJSX {
         "loadedResponse"?: BlazorInvokableFunction<(response: VehicleLookupDTO) => void>;
         "loadingStateChange"?: BlazorInvokableFunction<(isLoading: boolean) => void>;
         /**
+          * Appended to the campaign lookup request only, never to the trace request. A wrapper passes its `sscQueryString` — typically a lookup-logging flag — here rather than into `queryString`, so opening a campaign's evidence (a re-read of a lookup that was already logged) is never counted as another lookup. The host's endpoint must refuse to log traced requests as well.
+          * @default ''
+         */
+        "lookupQueryString"?: string;
+        /**
+          * Renders a click-to-pass stand-in for the reCAPTCHA widget. Implied by `isDev`; the real widget is only ever used in production mode.
           * @default false
          */
         "mockRecaptcha"?: boolean;
@@ -3870,13 +4015,14 @@ declare namespace LocalJSX {
          */
         "recaptchaKey"?: string;
         /**
-          * @default false
+          * Asked for the current headers before every request this component makes itself; lets a host refresh its token on demand.
          */
-        "showSsc"?: boolean;
+        "requestHeadersProvider"?: RequestHeadersProvider;
         /**
+          * Shows a per-campaign "why this status?" control. The host gates it on its own permission check; the trace lists claim and invoice details.
           * @default false
          */
-        "showWarranty"?: boolean;
+        "showTrace"?: boolean;
         /**
           * @default ''
          */
@@ -3894,10 +4040,9 @@ declare namespace LocalJSX {
     /**
      * Warranty coverage as a single dated rail: the standard warranty followed by every
      * extended coverage in sequence.
-     * Deliberately separate from `vehicle-warranty-details` rather than a mode of it. This
-     * panel shows warranty and nothing else — no campaign table, no reCAPTCHA, no unauthorized
-     * campaign lookup — so hosts adopt it by pointing their warranty tab at this tag and can
-     * keep the original panel untouched for as long as they like.
+     * This panel shows warranty and nothing else — no campaign table, no reCAPTCHA, no
+     * unauthorized campaign lookup; those belong to `vehicle-ssc`. Hosts point their warranty
+     * tab at this tag and their campaign tab at that one.
      */
     interface VehicleWarrantyTimeline {
         "baseUrl"?: string;
@@ -3911,6 +4056,7 @@ declare namespace LocalJSX {
         "disableVinValidation"?: boolean;
         "errorCallback"?: BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         /**
+          * Static headers the host set on the element. The floor every request starts from.
           * @default {}
          */
         "headers"?: object;
@@ -4461,6 +4607,7 @@ declare namespace LocalJSX {
         "baseUrl": string;
         "queryString": string;
         "uploadMultipleDocumentsAtTheForm": boolean;
+        "blazorRequestHeadersProvider": string;
         "errorCallback": BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         "loadingStateChange": BlazorInvokableFunction<(isLoading: boolean) => void>;
         "loadedResponse": BlazorInvokableFunction<(response: VehicleLookupDTO) => void>;
@@ -4483,9 +4630,9 @@ declare namespace LocalJSX {
         "disableVinValidation": boolean;
         "queryString": string;
         "sscQueryString": string;
-        "separateSsc": boolean;
         "hiddenTabs": string;
         "childrenProps": string | object;
+        "blazorRequestHeadersProvider": string;
         "blazorErrorStateListener": string;
         "blazorOnLoadingStateChange": string;
         "blazorDynamicClaimActivate": string;
@@ -4545,21 +4692,22 @@ declare namespace LocalJSX {
         "loadingStateChange": BlazorInvokableFunction<(isLoading: boolean) => void>;
         "loadedResponse": BlazorInvokableFunction<(response: VehicleLookupDTO) => void>;
     }
-    interface VehicleWarrantyDetailsAttributes {
+    interface VehicleSscAttributes {
         "language": LanguageKeys;
         "coreOnly": boolean;
         "isDev": boolean;
         "disableVinValidation": boolean;
         "baseUrl": string;
         "queryString": string;
+        "lookupQueryString": string;
+        "blazorRequestHeadersProvider": string;
         "errorCallback": BlazorInvokableFunction<(errorMessage: ErrorKeys) => void>;
         "loadingStateChange": BlazorInvokableFunction<(isLoading: boolean) => void>;
         "loadedResponse": BlazorInvokableFunction<(response: VehicleLookupDTO) => void>;
         "unauthorizedSscLookupResponse": BlazorInvokableFunction<(sscLookupStatus: number) => void>;
-        "showSsc": boolean;
+        "showTrace": boolean;
         "recaptchaKey": string;
         "mockRecaptcha": boolean;
-        "showWarranty": boolean;
         "unauthorizedSscLookupBaseUrl": string;
         "unauthorizedSscLookupQueryString": string;
         "cityId": string;
@@ -4660,7 +4808,7 @@ declare namespace LocalJSX {
         "vehicle-sale-information": Omit<VehicleSaleInformation, keyof VehicleSaleInformationAttributes> & { [K in keyof VehicleSaleInformation & keyof VehicleSaleInformationAttributes]?: VehicleSaleInformation[K] } & { [K in keyof VehicleSaleInformation & keyof VehicleSaleInformationAttributes as `attr:${K}`]?: VehicleSaleInformationAttributes[K] } & { [K in keyof VehicleSaleInformation & keyof VehicleSaleInformationAttributes as `prop:${K}`]?: VehicleSaleInformation[K] };
         "vehicle-service-history": Omit<VehicleServiceHistory, keyof VehicleServiceHistoryAttributes> & { [K in keyof VehicleServiceHistory & keyof VehicleServiceHistoryAttributes]?: VehicleServiceHistory[K] } & { [K in keyof VehicleServiceHistory & keyof VehicleServiceHistoryAttributes as `attr:${K}`]?: VehicleServiceHistoryAttributes[K] } & { [K in keyof VehicleServiceHistory & keyof VehicleServiceHistoryAttributes as `prop:${K}`]?: VehicleServiceHistory[K] };
         "vehicle-specification": Omit<VehicleSpecification, keyof VehicleSpecificationAttributes> & { [K in keyof VehicleSpecification & keyof VehicleSpecificationAttributes]?: VehicleSpecification[K] } & { [K in keyof VehicleSpecification & keyof VehicleSpecificationAttributes as `attr:${K}`]?: VehicleSpecificationAttributes[K] } & { [K in keyof VehicleSpecification & keyof VehicleSpecificationAttributes as `prop:${K}`]?: VehicleSpecification[K] };
-        "vehicle-warranty-details": Omit<VehicleWarrantyDetails, keyof VehicleWarrantyDetailsAttributes> & { [K in keyof VehicleWarrantyDetails & keyof VehicleWarrantyDetailsAttributes]?: VehicleWarrantyDetails[K] } & { [K in keyof VehicleWarrantyDetails & keyof VehicleWarrantyDetailsAttributes as `attr:${K}`]?: VehicleWarrantyDetailsAttributes[K] } & { [K in keyof VehicleWarrantyDetails & keyof VehicleWarrantyDetailsAttributes as `prop:${K}`]?: VehicleWarrantyDetails[K] };
+        "vehicle-ssc": Omit<VehicleSsc, keyof VehicleSscAttributes> & { [K in keyof VehicleSsc & keyof VehicleSscAttributes]?: VehicleSsc[K] } & { [K in keyof VehicleSsc & keyof VehicleSscAttributes as `attr:${K}`]?: VehicleSscAttributes[K] } & { [K in keyof VehicleSsc & keyof VehicleSscAttributes as `prop:${K}`]?: VehicleSsc[K] };
         "vehicle-warranty-timeline": Omit<VehicleWarrantyTimeline, keyof VehicleWarrantyTimelineAttributes> & { [K in keyof VehicleWarrantyTimeline & keyof VehicleWarrantyTimelineAttributes]?: VehicleWarrantyTimeline[K] } & { [K in keyof VehicleWarrantyTimeline & keyof VehicleWarrantyTimelineAttributes as `attr:${K}`]?: VehicleWarrantyTimelineAttributes[K] } & { [K in keyof VehicleWarrantyTimeline & keyof VehicleWarrantyTimelineAttributes as `prop:${K}`]?: VehicleWarrantyTimeline[K] };
         "vin-extractor": Omit<VinExtractor, keyof VinExtractorAttributes> & { [K in keyof VinExtractor & keyof VinExtractorAttributes]?: VinExtractor[K] } & { [K in keyof VinExtractor & keyof VinExtractorAttributes as `attr:${K}`]?: VinExtractorAttributes[K] } & { [K in keyof VinExtractor & keyof VinExtractorAttributes as `prop:${K}`]?: VinExtractor[K] };
     }
@@ -4761,14 +4909,37 @@ declare module "@stencil/core" {
             "vehicle-sale-information": LocalJSX.IntrinsicElements["vehicle-sale-information"] & JSXBase.HTMLAttributes<HTMLVehicleSaleInformationElement>;
             "vehicle-service-history": LocalJSX.IntrinsicElements["vehicle-service-history"] & JSXBase.HTMLAttributes<HTMLVehicleServiceHistoryElement>;
             "vehicle-specification": LocalJSX.IntrinsicElements["vehicle-specification"] & JSXBase.HTMLAttributes<HTMLVehicleSpecificationElement>;
-            "vehicle-warranty-details": LocalJSX.IntrinsicElements["vehicle-warranty-details"] & JSXBase.HTMLAttributes<HTMLVehicleWarrantyDetailsElement>;
+            /**
+             * The Special Service Campaigns (safety recalls) affecting a vehicle, and nothing else: warranty
+             * coverage lives in <vehicle-warranty-timeline>. Replaces the campaign half of the retired
+             * <vehicle-warranty-details>.
+             * A vehicle is on exactly one of two paths, and the panel must never mix them (the rule is spelled
+             * out on `panelVerdict` in ./components/SscCampaigns.tsx and in
+             * .shift/repos/adp/web-components/vehicle-lookup-invariants.md):
+             *  - authorized (in the distributor's records): the campaign list is the verdict;
+             *  - unauthorized: the distributor has no records, so the only verdict is the manufacturer's
+             *    answer to the reCAPTCHA-gated check — a yes/no, no list. Until it arrives the panel says the
+             *    vehicle is not in the records and asserts nothing else.
+             * A third state is neither: a wrapper that only counts the SSC tab's own request as a campaign
+             * check (`sscQueryString`) tells this panel through `skipLookup` that a vehicle was looked up
+             * without it. The panel then says the check was not run and offers to run it, rather than sitting
+             * blank next to a VIN as if the vehicle had no campaigns.
+             * With `show-trace`, every campaign row can open the evidence behind its repair status: the labor
+             * codes accepted for the campaign, every warranty claim on the vehicle with how it was judged, and
+             * the service-history lines that matched. The trace is fetched on first use with `?trace=ssc`, so
+             * the ordinary lookup response stays small and the host can gate the detail behind a permission.
+             * Every state change is a movement (lookup-motion.css): the outgoing content stays rendered while
+             * the body shuts over it, and the incoming content is swapped in only while the body is shut. The
+             * shared lookup helper waits a second before it asks the server, which is what guarantees the body
+             * has settled shut before a response can land.
+             */
+            "vehicle-ssc": LocalJSX.IntrinsicElements["vehicle-ssc"] & JSXBase.HTMLAttributes<HTMLVehicleSscElement>;
             /**
              * Warranty coverage as a single dated rail: the standard warranty followed by every
              * extended coverage in sequence.
-             * Deliberately separate from `vehicle-warranty-details` rather than a mode of it. This
-             * panel shows warranty and nothing else — no campaign table, no reCAPTCHA, no unauthorized
-             * campaign lookup — so hosts adopt it by pointing their warranty tab at this tag and can
-             * keep the original panel untouched for as long as they like.
+             * This panel shows warranty and nothing else — no campaign table, no reCAPTCHA, no
+             * unauthorized campaign lookup; those belong to `vehicle-ssc`. Hosts point their warranty
+             * tab at this tag and their campaign tab at that one.
              */
             "vehicle-warranty-timeline": LocalJSX.IntrinsicElements["vehicle-warranty-timeline"] & JSXBase.HTMLAttributes<HTMLVehicleWarrantyTimelineElement>;
             "vin-extractor": LocalJSX.IntrinsicElements["vin-extractor"] & JSXBase.HTMLAttributes<HTMLVinExtractorElement>;

package/dist/types/features/vehicle-lookup-component/index.d.ts

@@ -1,3 +1,4 @@
 export * from './types';
 export * from './interface';
 export * from './vehicle-lookup-api-integration';
+export * from './request-headers';

package/dist/types/features/vehicle-lookup-component/interface.d.ts

@@ -2,7 +2,8 @@ import { VehicleLookupDTO } from "../../global/types/generated/vehicle-lookup/ve
 import { ErrorKeys } from "../multi-lingual/index";
 import { BlazorInvokableFunction } from "../blazor-ref/index";
 import { VehicleLookupMock, VehicleRequestHeaders } from './types';
-export interface VehicleLookupComponent extends VehicleRequestHeaders {
+import { RequestHeadersSource } from './request-headers';
+export interface VehicleLookupComponent extends VehicleRequestHeaders, RequestHeadersSource {
     isDev: boolean;
     disableVinValidation?: boolean;
     baseUrl: string;
@@ -10,6 +11,12 @@ export interface VehicleLookupComponent extends VehicleRequestHeaders {
     isError: boolean;
     isLoading: boolean;
     queryString: string;
+    /**
+     * Appended to the vehicle lookup request only — never to a component's follow-up requests such as
+     * a trace. Where a host puts a lookup-logging flag: a trace re-reads a lookup that was already
+     * logged and must not be counted again.
+     */
+    lookupQueryString?: string;
     errorMessage?: ErrorKeys;
     mockData: VehicleLookupMock;
     vehicleLookup?: VehicleLookupDTO;