{
  "schemaVersion": 1,
  "package": "adp-web-components",
  "packageVersion": "0.4.25",
  "outputFamily": "per-component",
  "components": [
    {
      "tag": "vehicle-lookup",
      "modulePath": "dist/components/vehicle-lookup.js",
      "wireContract": "adp.vehicle-lookup.v1",
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": ["activeElement", "baseUrl", "childrenProps", "disableVinValidation", "hiddenTabs", "language", "queryString", "sscQueryString"],
        "methods": ["fetchVin"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["vehicle lookup request", "response distribution to child components", "active child rendering"]
      },
      "api": {
        "props": [
          {
            "name": "activeElement",
            "attribute": "active-element",
            "type": "\"\" | \"vehicle-accessories\" | \"vehicle-claimable-items\" | \"vehicle-paint-thickness\" | \"vehicle-sale-information\" | \"vehicle-service-history\" | \"vehicle-specification\" | \"vehicle-ssc\" | \"vehicle-warranty-timeline\"",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "baseUrl", "attribute": "base-url", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "blazorDynamicClaimActivate", "attribute": "blazor-dynamic-claim-activate", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "blazorErrorStateListener", "attribute": "blazor-error-state-listener", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "blazorOnLoadingStateChange", "attribute": "blazor-on-loading-state-change", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "blazorRequestHeadersProvider", "attribute": "blazor-request-headers-provider", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "childrenProps", "attribute": "children-props", "type": "object | string", "default": null, "mutable": false, "required": false },
          { "name": "disableVinValidation", "attribute": "disable-vin-validation", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "dynamicClaimActivate", "type": "(vehicleInformation: VehicleLookupDTO) => void", "default": null, "mutable": false, "required": false },
          { "name": "errorStateListener", "type": "(newError: string) => void", "default": null, "mutable": false, "required": false },
          { "name": "hiddenTabs", "attribute": "hidden-tabs", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "isDev", "attribute": "is-dev", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "language", "attribute": "language", "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"", "default": null, "mutable": false, "required": false },
          { "name": "loadingStateChanged", "type": "(isLoading: boolean) => void", "default": null, "mutable": false, "required": false },
          { "name": "mockRecaptcha", "attribute": "mock-recaptcha", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "mockUrl", "attribute": "mock-url", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "queryString", "attribute": "query-string", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "requestHeadersProvider", "type": "() => object | Promise<object>", "default": null, "mutable": false, "required": false },
          { "name": "sscQueryString", "attribute": "ssc-query-string", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "tabOrder", "attribute": "tab-order", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "today", "attribute": "today", "type": "string", "default": null, "mutable": false, "required": false }
        ],
        "methods": [
          { "name": "fetchVin", "parameters": "(vin: string, headers?: any) => Promise<void>", "returns": "Promise<void>" },
          { "name": "handleLoadData", "parameters": "(newResponse: VehicleLookupDTO, activeElement: any) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setBlazorRef", "parameters": "(newBlazorRef: DotNetObjectReference) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setMockData", "parameters": "(newMockData: VehicleLookupMock) => Promise<void>", "returns": "Promise<void>" }
        ],
        "events": [],
        "dependencies": [
          "vehicle-specification",
          "vehicle-accessories",
          "vehicle-sale-information",
          "vehicle-warranty-timeline",
          "vehicle-ssc",
          "vehicle-service-history",
          "vehicle-paint-thickness",
          "vehicle-claimable-items"
        ]
      },
      "runtimeAssets": {
        "locales": "dist/locales",
        "notes": [
          "The host owns tab navigation and selects the activeElement.",
          "With sscQueryString set, only a search made from the SSC tab counts as a campaign check; a search from another tab leaves the SSC tab saying the check was not run, with a control to run it. It reaches vehicle-ssc as lookupQueryString, so it never joins a trace request."
        ]
      }
    },
    {
      "tag": "vehicle-specification",
      "modulePath": "dist/components/vehicle-specification.js",
      "wireContract": "adp.vehicle-specification.v1",
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": ["baseUrl", "language", "coreOnly", "disableVinValidation", "queryString"],
        "methods": ["fetchVin"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["lookup request", "response handling", "loading and error state", "vehicle specification rendering"]
      },
      "api": {
        "props": [
          { "name": "baseUrl", "attribute": "base-url", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "coreOnly", "attribute": "core-only", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "disableVinValidation", "attribute": "disable-vin-validation", "type": "boolean", "default": null, "mutable": false, "required": false },
          {
            "name": "errorCallback",
            "attribute": "error-callback",
            "type": "((errorMessage: OptionalKeys<{ noBaseUrl: string; invalidVin: string; vinNumberRequired: string; partNumberRequired: string; wrongResponseFormat: string; noPartsFound: string; noServiceAvailable: string; wrongFormStructure: string; wildCard: string; requestFailedPleaseTryAgainLater: string; }>) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "headers", "type": "object", "default": null, "mutable": false, "required": false },
          { "name": "isDev", "attribute": "is-dev", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "language", "attribute": "language", "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"", "default": null, "mutable": false, "required": false },
          {
            "name": "loadedResponse",
            "attribute": "loaded-response",
            "type": "((response: VehicleLookupDTO) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          {
            "name": "loadingStateChange",
            "attribute": "loading-state-change",
            "type": "((isLoading: boolean) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "queryString", "attribute": "query-string", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "today", "attribute": "today", "type": "string", "default": null, "mutable": false, "required": false }
        ],
        "methods": [
          { "name": "clearData", "parameters": "() => Promise<void>", "returns": "Promise<void>" },
          { "name": "fetchVin", "parameters": "(newData: VehicleLookupDTO | string, headers?: any) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setBlazorRef", "parameters": "(newBlazorRef: DotNetObjectReference) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setErrorMessage", "parameters": "(message: ErrorKeys) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setMockData", "parameters": "(newMockData: VehicleLookupMock) => Promise<void>", "returns": "Promise<void>" }
        ],
        "events": [{ "name": "verdictChange", "type": "\"attention\" | \"idle\" | \"negative\" | \"neutral\" | \"positive\"" }],
        "dependencies": []
      },
      "runtimeAssets": { "locales": "dist/locales", "notes": [] }
    },
    {
      "tag": "vehicle-sale-information",
      "modulePath": "dist/components/vehicle-sale-information.js",
      "wireContract": "adp.vehicle-sale-information.v1",
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": ["baseUrl", "language", "coreOnly", "disableVinValidation", "hiddenFields", "queryString", "showSupplyChain"],
        "methods": ["fetchVin"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["lookup request", "response handling", "loading and error state", "sale information rendering"]
      },
      "api": {
        "props": [
          { "name": "baseUrl", "attribute": "base-url", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "coreOnly", "attribute": "core-only", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "disableVinValidation", "attribute": "disable-vin-validation", "type": "boolean", "default": null, "mutable": false, "required": false },
          {
            "name": "errorCallback",
            "attribute": "error-callback",
            "type": "((errorMessage: OptionalKeys<{ noBaseUrl: string; invalidVin: string; vinNumberRequired: string; partNumberRequired: string; wrongResponseFormat: string; noPartsFound: string; noServiceAvailable: string; wrongFormStructure: string; wildCard: string; requestFailedPleaseTryAgainLater: string; }>) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "headers", "type": "object", "default": null, "mutable": false, "required": false },
          { "name": "hiddenFields", "attribute": "hidden-fields", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "isDev", "attribute": "is-dev", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "language", "attribute": "language", "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"", "default": null, "mutable": false, "required": false },
          {
            "name": "loadedResponse",
            "attribute": "loaded-response",
            "type": "((response: VehicleLookupDTO) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          {
            "name": "loadingStateChange",
            "attribute": "loading-state-change",
            "type": "((isLoading: boolean) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "queryString", "attribute": "query-string", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "showSupplyChain", "attribute": "show-supply-chain", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "today", "attribute": "today", "type": "string", "default": null, "mutable": false, "required": false }
        ],
        "methods": [
          { "name": "clearData", "parameters": "() => Promise<void>", "returns": "Promise<void>" },
          { "name": "fetchVin", "parameters": "(newData: VehicleLookupDTO | string, headers?: any) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setBlazorRef", "parameters": "(newBlazorRef: DotNetObjectReference) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setErrorMessage", "parameters": "(message: ErrorKeys) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setMockData", "parameters": "(newMockData: VehicleLookupMock) => Promise<void>", "returns": "Promise<void>" }
        ],
        "events": [{ "name": "verdictChange", "type": "\"attention\" | \"idle\" | \"negative\" | \"neutral\" | \"positive\"" }],
        "dependencies": []
      },
      "runtimeAssets": {
        "locales": "dist/locales",
        "notes": [
          "The host may use hiddenFields to apply its approved presentation policy.",
          "showSupplyChain (default false) shows the sale as an ordered chain of legs: distributor, intermediaries, dealer, broker, end customer. Inside vehicle-lookup the host passes it through childrenProps, like showTrace."
        ]
      }
    },
    {
      "tag": "vehicle-accessories",
      "modulePath": "dist/components/vehicle-accessories.js",
      "wireContract": "adp.vehicle-accessories.v1",
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": ["baseUrl", "language", "coreOnly", "disableVinValidation", "queryString"],
        "methods": ["fetchVin"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["lookup request", "response handling", "loading and error state", "accessory rendering"]
      },
      "api": {
        "props": [
          { "name": "baseUrl", "attribute": "base-url", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "coreOnly", "attribute": "core-only", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "disableVinValidation", "attribute": "disable-vin-validation", "type": "boolean", "default": null, "mutable": false, "required": false },
          {
            "name": "errorCallback",
            "attribute": "error-callback",
            "type": "((errorMessage: OptionalKeys<{ noBaseUrl: string; invalidVin: string; vinNumberRequired: string; partNumberRequired: string; wrongResponseFormat: string; noPartsFound: string; noServiceAvailable: string; wrongFormStructure: string; wildCard: string; requestFailedPleaseTryAgainLater: string; }>) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "headers", "type": "object", "default": null, "mutable": false, "required": false },
          { "name": "hiddenFields", "attribute": "hidden-fields", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "isDev", "attribute": "is-dev", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "language", "attribute": "language", "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"", "default": null, "mutable": false, "required": false },
          {
            "name": "loadedResponse",
            "attribute": "loaded-response",
            "type": "((response: VehicleLookupDTO) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          {
            "name": "loadingStateChange",
            "attribute": "loading-state-change",
            "type": "((isLoading: boolean) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "pagination", "attribute": "pagination", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "queryString", "attribute": "query-string", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "today", "attribute": "today", "type": "string", "default": null, "mutable": false, "required": false }
        ],
        "methods": [
          { "name": "clearData", "parameters": "() => Promise<void>", "returns": "Promise<void>" },
          { "name": "fetchVin", "parameters": "(newData: VehicleLookupDTO | string, headers?: object) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setBlazorRef", "parameters": "(newBlazorRef: DotNetObjectReference) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setErrorMessage", "parameters": "(message: ErrorKeys) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setMockData", "parameters": "(newMockData: VehicleLookupMock) => Promise<void>", "returns": "Promise<void>" }
        ],
        "events": [{ "name": "verdictChange", "type": "\"attention\" | \"idle\" | \"negative\" | \"neutral\" | \"positive\"" }],
        "dependencies": ["shift-image"]
      },
      "runtimeAssets": { "locales": "dist/locales", "notes": [] }
    },
    {
      "tag": "vehicle-service-history",
      "modulePath": "dist/components/vehicle-service-history.js",
      "wireContract": "adp.vehicle-service-history.v1",
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": ["baseUrl", "language", "coreOnly", "disableVinValidation", "queryString"],
        "methods": ["fetchVin"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["lookup request", "response handling", "loading and error state", "service-history rendering"]
      },
      "api": {
        "props": [
          { "name": "baseUrl", "attribute": "base-url", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "coreOnly", "attribute": "core-only", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "disableVinValidation", "attribute": "disable-vin-validation", "type": "boolean", "default": null, "mutable": false, "required": false },
          {
            "name": "errorCallback",
            "attribute": "error-callback",
            "type": "((errorMessage: OptionalKeys<{ noBaseUrl: string; invalidVin: string; vinNumberRequired: string; partNumberRequired: string; wrongResponseFormat: string; noPartsFound: string; noServiceAvailable: string; wrongFormStructure: string; wildCard: string; requestFailedPleaseTryAgainLater: string; }>) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "headers", "type": "object", "default": null, "mutable": false, "required": false },
          { "name": "isDev", "attribute": "is-dev", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "language", "attribute": "language", "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"", "default": null, "mutable": false, "required": false },
          {
            "name": "loadedResponse",
            "attribute": "loaded-response",
            "type": "((response: VehicleLookupDTO) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          {
            "name": "loadingStateChange",
            "attribute": "loading-state-change",
            "type": "((isLoading: boolean) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "pagination", "attribute": "pagination", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "queryString", "attribute": "query-string", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "today", "attribute": "today", "type": "string", "default": null, "mutable": false, "required": false }
        ],
        "methods": [
          { "name": "clearData", "parameters": "() => Promise<void>", "returns": "Promise<void>" },
          { "name": "fetchVin", "parameters": "(newData: VehicleLookupDTO | string, headers?: object) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setBlazorRef", "parameters": "(newBlazorRef: DotNetObjectReference) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setErrorMessage", "parameters": "(message: ErrorKeys) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setMockData", "parameters": "(newMockData: VehicleLookupMock) => Promise<void>", "returns": "Promise<void>" }
        ],
        "events": [{ "name": "verdictChange", "type": "\"attention\" | \"idle\" | \"negative\" | \"neutral\" | \"positive\"" }],
        "dependencies": []
      },
      "runtimeAssets": { "locales": "dist/locales", "notes": ["The current package global script loads shared fonts and browser interop helpers."] }
    },
    {
      "tag": "vehicle-paint-thickness",
      "modulePath": "dist/components/vehicle-paint-thickness.js",
      "wireContract": "adp.vehicle-paint-thickness.v1",
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": ["baseUrl", "language", "coreOnly", "disableVinValidation", "queryString", "showCertificateButton"],
        "methods": ["fetchVin"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["lookup request", "response handling", "loading and error state", "paint-thickness rendering"]
      },
      "api": {
        "props": [
          { "name": "baseUrl", "attribute": "base-url", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "coreOnly", "attribute": "core-only", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "disableVinValidation", "attribute": "disable-vin-validation", "type": "boolean", "default": null, "mutable": false, "required": false },
          {
            "name": "errorCallback",
            "attribute": "error-callback",
            "type": "((errorMessage: OptionalKeys<{ noBaseUrl: string; invalidVin: string; vinNumberRequired: string; partNumberRequired: string; wrongResponseFormat: string; noPartsFound: string; noServiceAvailable: string; wrongFormStructure: string; wildCard: string; requestFailedPleaseTryAgainLater: string; }>) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "headers", "type": "object", "default": null, "mutable": false, "required": false },
          { "name": "hiddenFields", "attribute": "hidden-fields", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "isDev", "attribute": "is-dev", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "language", "attribute": "language", "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"", "default": null, "mutable": false, "required": false },
          {
            "name": "loadedResponse",
            "attribute": "loaded-response",
            "type": "((response: VehicleLookupDTO) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          {
            "name": "loadingStateChange",
            "attribute": "loading-state-change",
            "type": "((isLoading: boolean) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "queryString", "attribute": "query-string", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "showCertificateButton", "attribute": "show-certificate-button", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "showReadingSummary", "attribute": "show-reading-summary", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "today", "attribute": "today", "type": "string", "default": null, "mutable": false, "required": false }
        ],
        "methods": [
          { "name": "clearData", "parameters": "() => Promise<void>", "returns": "Promise<void>" },
          { "name": "fetchVin", "parameters": "(newData: VehicleLookupDTO | string, headers?: object) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setBlazorRef", "parameters": "(newBlazorRef: DotNetObjectReference) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setErrorMessage", "parameters": "(message: ErrorKeys) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setMockData", "parameters": "(newMockData: VehicleLookupMock) => Promise<void>", "returns": "Promise<void>" }
        ],
        "events": [{ "name": "verdictChange", "type": "\"attention\" | \"idle\" | \"negative\" | \"neutral\" | \"positive\"" }],
        "dependencies": ["shift-image", "shift-popover", "vehicle-paint-thickness-popup", "shift-tabs"]
      },
      "runtimeAssets": { "locales": "dist/locales", "notes": [] }
    },
    {
      "tag": "vehicle-ssc",
      "modulePath": "dist/components/vehicle-ssc.js",
      "wireContract": "adp.vehicle-ssc.v1",
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": ["baseUrl", "language", "coreOnly", "disableVinValidation", "queryString", "lookupQueryString", "showTrace"],
        "methods": ["fetchVin"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["lookup request", "response handling", "loading and error state", "campaign rendering", "repair-status trace fetch"]
      },
      "api": {
        "props": [
          { "name": "baseUrl", "attribute": "base-url", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "blazorRequestHeadersProvider", "attribute": "blazor-request-headers-provider", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "brandIntegrationId", "attribute": "brand-integration-id", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "cityId", "attribute": "city-id", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "cityIntegrationId", "attribute": "city-integration-id", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "companyBranchId", "attribute": "company-branch-id", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "companyBranchIntegrationId", "attribute": "company-branch-integration-id", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "companyId", "attribute": "company-id", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "companyIntegrationId", "attribute": "company-integration-id", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "coreOnly", "attribute": "core-only", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "customerEmail", "attribute": "customer-email", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "customerName", "attribute": "customer-name", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "customerPhone", "attribute": "customer-phone", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "disableVinValidation", "attribute": "disable-vin-validation", "type": "boolean", "default": null, "mutable": false, "required": false },
          {
            "name": "errorCallback",
            "attribute": "error-callback",
            "type": "((errorMessage: OptionalKeys<{ noBaseUrl: string; invalidVin: string; vinNumberRequired: string; partNumberRequired: string; wrongResponseFormat: string; noPartsFound: string; noServiceAvailable: string; wrongFormStructure: string; wildCard: string; requestFailedPleaseTryAgainLater: string; }>) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "headers", "type": "object", "default": null, "mutable": false, "required": false },
          { "name": "isDev", "attribute": "is-dev", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "language", "attribute": "language", "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"", "default": null, "mutable": false, "required": false },
          {
            "name": "loadedResponse",
            "attribute": "loaded-response",
            "type": "((response: VehicleLookupDTO) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          {
            "name": "loadingStateChange",
            "attribute": "loading-state-change",
            "type": "((isLoading: boolean) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "lookupQueryString", "attribute": "lookup-query-string", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "mockRecaptcha", "attribute": "mock-recaptcha", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "queryString", "attribute": "query-string", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "recaptchaKey", "attribute": "recaptcha-key", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "requestHeadersProvider", "type": "() => object | Promise<object>", "default": null, "mutable": false, "required": false },
          { "name": "showTrace", "attribute": "show-trace", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "today", "attribute": "today", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "unauthorizedSscLookupBaseUrl", "attribute": "unauthorized-ssc-lookup-base-url", "type": "string", "default": null, "mutable": false, "required": false },
          {
            "name": "unauthorizedSscLookupQueryString",
            "attribute": "unauthorized-ssc-lookup-query-string",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false
          },
          {
            "name": "unauthorizedSscLookupResponse",
            "attribute": "unauthorized-ssc-lookup-response",
            "type": "((sscLookupStatus: number) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "userId", "attribute": "user-id", "type": "string", "default": null, "mutable": false, "required": false }
        ],
        "methods": [
          { "name": "clearData", "parameters": "() => Promise<void>", "returns": "Promise<void>" },
          { "name": "fetchVin", "parameters": "(newData: VehicleLookupDTO | string, headers?: any) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setBlazorRef", "parameters": "(newBlazorRef: DotNetObjectReference) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setErrorMessage", "parameters": "(message: ErrorKeys) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setMockData", "parameters": "(newMockData: VehicleLookupMock) => Promise<void>", "returns": "Promise<void>" },
          { "name": "skipLookup", "parameters": "(vin: string) => Promise<void>", "returns": "Promise<void>" }
        ],
        "events": [{ "name": "verdictChange", "type": "\"attention\" | \"idle\" | \"negative\" | \"neutral\" | \"positive\"" }],
        "dependencies": []
      },
      "runtimeAssets": {
        "locales": "dist/locales",
        "notes": [
          "Replaces the campaign half of the retired vehicle-warranty-details; warranty coverage is vehicle-warranty-timeline.",
          "Unauthorized campaign lookup and reCAPTCHA configuration are host policy and remain optional raw API properties.",
          "showTrace exposes claim and invoice details per campaign; the host gates it on its own permission check and its endpoint must honour ?trace=ssc.",
          "A lookup-logging flag belongs in lookupQueryString, which joins the lookup request only: the trace request re-reads a lookup already logged and never carries it. The host endpoint must refuse to log traced requests as well (the ADP lookup service does).",
          "Opening a campaign's evidence brings its row to the top of the page and follows the page while the drawer opens; a host whose fixed header covers the top of the page sets scroll-padding-top on its scroll container."
        ]
      }
    },
    {
      "tag": "vehicle-warranty-timeline",
      "modulePath": "dist/components/vehicle-warranty-timeline.js",
      "wireContract": "adp.vehicle-warranty-timeline.v1",
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": ["baseUrl", "language", "coreOnly", "disableVinValidation", "queryString"],
        "methods": ["fetchVin"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["lookup request", "response handling", "loading and error state", "warranty coverage rendering"]
      },
      "api": {
        "props": [
          { "name": "baseUrl", "attribute": "base-url", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "coreOnly", "attribute": "core-only", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "disableVinValidation", "attribute": "disable-vin-validation", "type": "boolean", "default": null, "mutable": false, "required": false },
          {
            "name": "errorCallback",
            "attribute": "error-callback",
            "type": "((errorMessage: OptionalKeys<{ noBaseUrl: string; invalidVin: string; vinNumberRequired: string; partNumberRequired: string; wrongResponseFormat: string; noPartsFound: string; noServiceAvailable: string; wrongFormStructure: string; wildCard: string; requestFailedPleaseTryAgainLater: string; }>) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "headers", "type": "object", "default": null, "mutable": false, "required": false },
          { "name": "isDev", "attribute": "is-dev", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "language", "attribute": "language", "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"", "default": null, "mutable": false, "required": false },
          {
            "name": "loadedResponse",
            "attribute": "loaded-response",
            "type": "((response: VehicleLookupDTO) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          {
            "name": "loadingStateChange",
            "attribute": "loading-state-change",
            "type": "((isLoading: boolean) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "queryString", "attribute": "query-string", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "today", "attribute": "today", "type": "string", "default": null, "mutable": false, "required": false }
        ],
        "methods": [
          { "name": "clearData", "parameters": "() => Promise<void>", "returns": "Promise<void>" },
          { "name": "fetchVin", "parameters": "(newData: VehicleLookupDTO | string, headers?: any) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setBlazorRef", "parameters": "(newBlazorRef: DotNetObjectReference) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setErrorMessage", "parameters": "(message: ErrorKeys) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setMockData", "parameters": "(newMockData: VehicleLookupMock) => Promise<void>", "returns": "Promise<void>" }
        ],
        "events": [{ "name": "verdictChange", "type": "\"attention\" | \"idle\" | \"negative\" | \"neutral\" | \"positive\"" }],
        "dependencies": []
      },
      "runtimeAssets": { "locales": "dist/locales", "notes": ["Warranty coverage only. Campaign rendering, reCAPTCHA and unauthorized campaign lookup belong to vehicle-ssc."] }
    },
    {
      "tag": "vehicle-claimable-items",
      "modulePath": "dist/components/vehicle-claimable-items.js",
      "wireContract": "adp.vehicle-claimable-items.v1",
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": ["baseUrl", "coreOnly", "disableVinValidation", "language", "queryString", "showTrace"],
        "methods": ["fetchVin"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["lookup request", "response handling", "loading and error state", "claimable-item rendering"]
      },
      "api": {
        "props": [
          { "name": "activate", "type": "(vehicleInformation: VehicleLookupDTO) => void", "default": null, "mutable": false, "required": false },
          { "name": "baseUrl", "attribute": "base-url", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "blazorRequestHeadersProvider", "attribute": "blazor-request-headers-provider", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "claimEndPoint", "attribute": "claim-end-point", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "coreOnly", "attribute": "core-only", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "disableVinValidation", "attribute": "disable-vin-validation", "type": "boolean", "default": null, "mutable": false, "required": false },
          {
            "name": "errorCallback",
            "attribute": "error-callback",
            "type": "((errorMessage: OptionalKeys<{ noBaseUrl: string; invalidVin: string; vinNumberRequired: string; partNumberRequired: string; wrongResponseFormat: string; noPartsFound: string; noServiceAvailable: string; wrongFormStructure: string; wildCard: string; requestFailedPleaseTryAgainLater: string; }>) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "headers", "type": "object", "default": null, "mutable": false, "required": false },
          { "name": "isDev", "attribute": "is-dev", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "language", "attribute": "language", "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"", "default": null, "mutable": false, "required": false },
          {
            "name": "loadedResponse",
            "attribute": "loaded-response",
            "type": "((response: VehicleLookupDTO) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          {
            "name": "loadingStateChange",
            "attribute": "loading-state-change",
            "type": "((isLoading: boolean) => void) | string",
            "default": null,
            "mutable": false,
            "required": false
          },
          { "name": "maximumDocumentFileSizeInMb", "attribute": "maximum-document-file-size-in-mb", "type": "number", "default": null, "mutable": false, "required": false },
          { "name": "print", "type": "(claimResponse: any) => void", "default": null, "mutable": false, "required": false },
          { "name": "queryString", "attribute": "query-string", "type": "string", "default": null, "mutable": false, "required": false },
          { "name": "requestHeadersProvider", "type": "() => object | Promise<object>", "default": null, "mutable": false, "required": false },
          { "name": "showTrace", "attribute": "show-trace", "type": "boolean", "default": null, "mutable": false, "required": false },
          { "name": "today", "attribute": "today", "type": "string", "default": null, "mutable": false, "required": false },
          {
            "name": "uploadMultipleDocumentsAtTheForm",
            "attribute": "upload-multiple-documents-at-the-form",
            "type": "boolean",
            "default": null,
            "mutable": false,
            "required": false
          }
        ],
        "methods": [
          { "name": "claim", "parameters": "(item: VehicleServiceItemDTO) => Promise<void>", "returns": "Promise<void>" },
          { "name": "completeClaim", "parameters": "(response: any) => Promise<void>", "returns": "Promise<void>" },
          { "name": "fetchVin", "parameters": "(newData: VehicleLookupDTO | string, headers?: any) => Promise<void>", "returns": "Promise<void>" },
          { "name": "openTrace", "parameters": "() => Promise<void>", "returns": "Promise<void>" },
          { "name": "setBlazorRef", "parameters": "(newBlazorRef: DotNetObjectReference) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setErrorMessage", "parameters": "(message: ErrorKeys) => Promise<void>", "returns": "Promise<void>" },
          { "name": "setMockData", "parameters": "(newMockData: VehicleLookupMock) => Promise<void>", "returns": "Promise<void>" }
        ],
        "events": [{ "name": "verdictChange", "type": "\"attention\" | \"idle\" | \"negative\" | \"neutral\" | \"positive\"" }],
        "dependencies": ["vehicle-item-claim-form", "shift-tabs", "vehicle-service-requirement"]
      },
      "runtimeAssets": {
        "locales": "dist/locales",
        "notes": [
          "claim, completeClaim, activate, claimEndPoint, and document-upload settings are mutation integration features. They remain raw API metadata until their host contract is reviewed."
        ]
      }
    },
    {
      "tag": "shift-calendar",
      "modulePath": "dist/components/shift-calendar.js",
      "wireContract": null,
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": [
          "value",
          "month",
          "min",
          "max",
          "disabledDates",
          "disabledWeekdays",
          "enabledDates",
          "isDateDisabled",
          "dayMeta",
          "today",
          "language",
          "weekStartsOn",
          "numerals",
          "label",
          "disabled",
          "busy",
          "highlightToday",
          "disableViews",
          "appearance",
          "colorScheme",
          "showToday",
          "size"
        ],
        "methods": ["setFocus"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["month grid rendering", "month and year views", "month navigation", "keyboard navigation", "single-date selection", "appearance and colour scheme"]
      },
      "api": {
        "props": [
          {
            "name": "appearance",
            "attribute": "appearance",
            "type": "\"material\" | \"minimal\" | \"sharp\" | \"soft\" | \"vanilla\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "vanilla, material, soft, sharp or minimal. Unset renders vanilla. A form passes data.appearance (or the field’s own) through the structure."
          },
          {
            "name": "busy",
            "attribute": "busy",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "The host is loading data: days dim and cannot be selected, keyboard focus still moves. Sets aria-busy on the grid."
          },
          {
            "name": "colorScheme",
            "attribute": "color-scheme",
            "type": "\"auto\" | \"dark\" | \"light\"",
            "default": "'light'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "light (default), dark, or auto (follows prefers-color-scheme; for hosts that are themselves dark-aware)."
          },
          {
            "name": "dayMeta",
            "attribute": "day-meta",
            "type": "string | { [x: string]: CalendarDayMeta; }",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Per-day extras keyed by YYYY-MM-DD: { badge?: short text, tone?: neutral | info | success | warning | danger, tooltip?: text shown over the day on mouse hover or keyboard focus (never on touch), description?: read with the date by screen readers }. Badge digits are written in the calendar’s numerals. Object or JSON string."
          },
          {
            "name": "disableViews",
            "attribute": "disable-views",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Turns the month and year views off; the header title becomes plain text. Off by default, because open-ended dates such as birthdates need the views."
          },
          {
            "name": "disabled",
            "attribute": "disabled",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "Nothing can be selected or navigated; no day is in the tab order."
          },
          {
            "name": "disabledDates",
            "attribute": "disabled-dates",
            "type": "string | string[]",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Dates that cannot be chosen: an array or a comma, space or JSON-array string of YYYY-MM-DD."
          },
          {
            "name": "disabledWeekdays",
            "attribute": "disabled-weekdays",
            "type": "number[] | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Weekdays that cannot be chosen, 0 Sunday … 6 Saturday: [5, 6], \"5,6\", \"5 6\" or \"[5,6]\"."
          },
          {
            "name": "enabledDates",
            "attribute": "enabled-dates",
            "type": "string | string[]",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Allow-list. When set (any array, even an empty one) only these dates can be chosen. Null, undefined or an empty string turns it off."
          },
          {
            "name": "highlightToday",
            "attribute": "highlight-today",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Marks today, the current month and the current year visually, in the appearance’s own way. Off by default: today then looks like any other day. aria-current=\"date\" is set on today either way."
          },
          {
            "name": "isDateDisabled",
            "type": "(date: string) => boolean",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "JS property only. (date) => boolean for any other rule; asked only about days no other rule blocked. A throw counts as disabled."
          },
          {
            "name": "label",
            "attribute": "label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Accessible name for the calendar group (the field label when used in a form). Default: the localized word for calendar."
          },
          {
            "name": "language",
            "attribute": "language",
            "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"",
            "default": "'en'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "en, ar, ku or ru. Sets names, direction, default week start and digits."
          },
          {
            "name": "max",
            "attribute": "max",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Latest selectable date (inclusive). Navigation stops at its month."
          },
          {
            "name": "min",
            "attribute": "min",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Earliest selectable date (inclusive). Navigation stops at its month. A min after max makes the range empty (see the notes)."
          },
          {
            "name": "month",
            "attribute": "month",
            "type": "string",
            "default": null,
            "mutable": true,
            "required": false,
            "reflect": true,
            "description": "Month shown in the days view, as YYYY-MM. Settable; clamped to min/max. Opens on the value’s month, else today’s, else the nearest end of the range. Choosing a month or a year in the views moves it."
          },
          {
            "name": "numerals",
            "attribute": "numerals",
            "type": "\"arab\" | \"latn\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "latn or arab. Default by language: Arabic-Indic digits for ar and ku, Latin for en and ru."
          },
          {
            "name": "showToday",
            "attribute": "show-today",
            "type": "boolean",
            "default": "true",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Shows the Today button. On by default. Off removes it; the title and the month buttons stay exactly where they were."
          },
          {
            "name": "size",
            "attribute": "size",
            "type": "\"lg\" | \"md\" | \"sm\" | \"xl\" | \"xs\"",
            "default": "'md'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "xs, sm, md (default), lg or xl. Scales cells, type, gaps and default width (300–500px). md equals no size; lg and xl keep a larger minimum width."
          },
          {
            "name": "today",
            "attribute": "today",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "YYYY-MM-DD that stands in for today, through ~lib/clock. Empty: the reader’s local calendar date."
          },
          {
            "name": "value",
            "attribute": "value",
            "type": "string",
            "default": "''",
            "mutable": true,
            "required": false,
            "reflect": true,
            "description": "Selected date as YYYY-MM-DD, or empty. Updated when the user selects a day; a host may set it."
          },
          {
            "name": "weekStartsOn",
            "attribute": "week-starts-on",
            "type": "number",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "First column, 0 Sunday … 6 Saturday. Default by language: en and ru Monday, ar and ku Saturday."
          }
        ],
        "methods": [
          {
            "name": "setFocus",
            "parameters": "(date?: string) => Promise<void>",
            "returns": "Promise<void>",
            "description": "Moves focus to the item in the tab order of the current view."
          }
        ],
        "events": [
          {
            "name": "dateChange",
            "type": "CalendarDateChangeDetail",
            "description": "Detail { value: YYYY-MM-DD }. Fires on every user selection — a day, or the Today button when today is selectable — including re-selecting the current value; never for a disabled day or when a host sets value."
          },
          {
            "name": "monthChange",
            "type": "CalendarMonthChangeDetail",
            "description": "Detail { month, firstDate, lastDate }. Fires whenever the days view shows another month, except when the host sets month. Use it to load that month’s data."
          },
          {
            "name": "pickerChange",
            "type": "PickerChangeDetail",
            "description": "The headless picker contract. Detail { value: YYYY-MM-DD, label: the date in words, complete: true }. Fires with dateChange; a host (shift-input with the calendar in its picker slot, or a button with shift-popover) shows label and closes on complete."
          },
          {
            "name": "viewChange",
            "type": "CalendarViewChangeDetail",
            "description": "Detail { view: days | months | years }. Fires when the view changes. Switching views never changes value."
          }
        ],
        "dependencies": [],
        "parts": [
          { "name": "root", "description": "The calendar box." },
          { "name": "header", "description": "Row holding the month heading and the controls." },
          { "name": "heading", "description": "The header title, rolling on every month and view change." },
          { "name": "nav", "description": "The Today, previous and next buttons, at the end of the header." },
          {
            "name": "today",
            "description": "Today button: selects today (value, dateChange) and shows its month; when today is disabled by a rule it only navigates and focuses. Its label shows whenever the header has room for it, otherwise the icon alone with the same accessible name. Disabled when today is outside min/max; removed with showToday false."
          },
          { "name": "prev", "description": "Previous month button." },
          { "name": "next", "description": "Next month button." },
          { "name": "grid", "description": "The role=grid element." },
          { "name": "weekdays", "description": "Weekday header row." },
          { "name": "weekday", "description": "One weekday heading." },
          { "name": "week", "description": "One row of seven days." },
          { "name": "day", "description": "Every day cell. State parts are added beside it: day-outside, day-selected, day-today, day-disabled, day-closed." },
          { "name": "day-outside", "description": "A day of the neighbouring month (muted, not selectable)." },
          { "name": "day-selected", "description": "The selected day." },
          { "name": "day-today", "description": "Today, with highlightToday only." },
          { "name": "day-disabled", "description": "Any day that cannot be selected." },
          { "name": "day-closed", "description": "A day ruled out by disabledDates, disabledWeekdays or isDateDisabled (struck through)." },
          { "name": "day-number", "description": "The day number inside a cell." },
          { "name": "badge", "description": "The dayMeta badge inside a cell." },
          {
            "name": "month-button",
            "description": "The month, after the year; opens the months view. Rolls only when the month changes. Disabled when min and max fall in the same month, or with disableViews."
          },
          {
            "name": "year-button",
            "description": "The year, first in the header (inline start in RTL); opens the years view. Rolls only when the year changes. Disabled when min and max fall in the same year, or with disableViews."
          },
          { "name": "months", "description": "The months view grid (3 × 4)." },
          { "name": "month", "description": "A month in the months view. States beside it: month-selected, month-today, month-disabled." },
          { "name": "month-selected", "description": "The month shown in the days view." },
          { "name": "month-today", "description": "The current month, with highlightToday." },
          { "name": "month-disabled", "description": "A month entirely outside min/max." },
          { "name": "years", "description": "The years view grid (12 years)." },
          { "name": "year", "description": "A year in the years view. States beside it: year-selected, year-today, year-disabled." },
          { "name": "year-selected", "description": "The year shown in the days view." },
          { "name": "year-today", "description": "The current year, with highlightToday." },
          { "name": "year-disabled", "description": "A year entirely outside min/max." },
          { "name": "tooltip", "description": "The one tooltip over the hovered or keyboard-focused day." }
        ],
        "cssProperties": [
          { "name": "--shift-calendar-accent", "default": "var(--shift-accent, var(--_ap-accent, #1e293b))", "description": "Colour · selected day fill" },
          { "name": "--shift-calendar-accent-tint", "default": "var(--shift-accent-tint, var(--_ap-accent-tint, #f1f5f9))", "description": "Colour · soft accent wash" },
          { "name": "--shift-calendar-badge-font-size", "default": "calc(10px + var(--_sz-font, 0px) / 2)", "description": "Type · badge size" },
          { "name": "--shift-calendar-badge-font-weight", "default": "700", "description": "Type · badge weight" },
          { "name": "--shift-calendar-badge-inset", "default": "3px", "description": "Spacing · badge distance from the cell edge" },
          { "name": "--shift-calendar-badge-line-height", "default": "12px", "description": "Type · badge line height" },
          { "name": "--shift-calendar-badge-padding-inline", "default": "4px", "description": "Spacing · badge padding" },
          { "name": "--shift-calendar-badge-radius", "default": "999px", "description": "Shape · badge radius" },
          { "name": "--shift-calendar-badge-shift", "default": "5px", "description": "Spacing · how far the number rises for a badge" },
          {
            "name": "--shift-calendar-blocked-decoration",
            "default": "var(--_ap-blocked-decoration, line-through)",
            "description": "Closed days · number decoration (e.g. line-through)"
          },
          { "name": "--shift-calendar-blocked-opacity", "default": "var(--_ap-blocked-opacity, 1)", "description": "Closed days · opacity" },
          { "name": "--shift-calendar-border-width", "default": "var(--shift-border-width, var(--_ap-border-width, 1px))", "description": "Shape · cell and button border width" },
          { "name": "--shift-calendar-button-gap", "default": "calc(6px * var(--_sz-space, 1))", "description": "Spacing · between icon and label in a button" },
          { "name": "--shift-calendar-button-radius", "default": "var(--shift-radius-md, var(--_ap-radius-md, 8px))", "description": "Shape · header button radius" },
          {
            "name": "--shift-calendar-day-font-size",
            "default": "var(--shift-font-size, calc(var(--_ap-font-size, 14px) + var(--_sz-font, 0px)))",
            "description": "Type · day number size"
          },
          { "name": "--shift-calendar-day-font-weight", "default": "var(--shift-weight-strong, var(--_ap-weight-strong, 600))", "description": "Type · day number weight" },
          { "name": "--shift-calendar-day-hover-bg", "default": "var(--_ap-hover-bg, #f1f5f9)", "description": "Colour · day background on hover" },
          { "name": "--shift-calendar-day-hover-ink", "default": "var(--_ap-hover-ink, #1e293b)", "description": "Colour · day number on hover" },
          { "name": "--shift-calendar-day-hover-line", "default": "var(--shift-line-strong, var(--_ap-hover-line, #94a3b8))", "description": "Colour · day outline on hover" },
          { "name": "--shift-calendar-day-ink", "default": "var(--shift-ink, var(--_ap-ink, #1e293b))", "description": "Colour · day numbers" },
          { "name": "--shift-calendar-day-line", "default": "var(--_ap-cell-line, transparent)", "description": "Colour · day cell outline at rest" },
          { "name": "--shift-calendar-day-max-inline-size", "default": "none", "description": "Size · widest a day cell may get" },
          { "name": "--shift-calendar-day-radius", "default": "var(--shift-radius-sm, var(--_ap-radius-sm, 8px))", "description": "Shape · day and month cell radius" },
          { "name": "--shift-calendar-day-round", "default": "var(--_ap-cell-round, 0)", "description": "Shape · 1 makes day cells circles, 0 fills the column" },
          {
            "name": "--shift-calendar-day-size",
            "default": "var(--shift-cell-size, calc(var(--_ap-cell-size, 40px) * var(--_sz-control, 1)))",
            "description": "Size · day cell height"
          },
          { "name": "--shift-calendar-disabled-font-weight", "default": "var(--shift-weight, var(--_ap-weight, 400))", "description": "Type · unavailable day weight" },
          { "name": "--shift-calendar-disabled-ink", "default": "var(--shift-ink-disabled, var(--_ap-ink-disabled, #cbd5e1))", "description": "Colour · unavailable days" },
          { "name": "--shift-calendar-ease", "default": "var(--shift-ease, ease)", "description": "Motion · easing of every movement" },
          { "name": "--shift-calendar-focus-halo", "default": "var(--_ap-focus-halo, transparent)", "description": "Colour · halo around a focused button" },
          { "name": "--shift-calendar-focus-halo-width", "default": "var(--_ap-focus-halo-width, 0px)", "description": "Focus · halo width" },
          { "name": "--shift-calendar-focus-inner", "default": "var(--_ap-focus-inner, #ffffff)", "description": "Colour · band inside a cell’s focus ring" },
          { "name": "--shift-calendar-focus-ring", "default": "var(--shift-focus, var(--_ap-focus, #1e293b))", "description": "Colour · focus ring" },
          { "name": "--shift-calendar-focus-ring-offset", "default": "var(--_ap-focus-offset, 2px)", "description": "Focus · gap between a button and its ring" },
          { "name": "--shift-calendar-focus-ring-width", "default": "var(--_ap-focus-width, 2px)", "description": "Focus · ring width" },
          { "name": "--shift-calendar-font-family", "default": "var(--shift-font-family, var(--_ap-font, 'Nunito', system-ui, sans-serif))", "description": "Type · Latin font" },
          {
            "name": "--shift-calendar-font-family-arabic",
            "default": "var(--shift-font-family-arabic, 'Noto Kufi Arabic', var(--_font-latin))",
            "description": "Type · Arabic and Kurdish font"
          },
          { "name": "--shift-calendar-font-size", "default": "var(--shift-font-size, calc(var(--_ap-font-size, 14px) + var(--_sz-font, 0px)))", "description": "Type · base size" },
          { "name": "--shift-calendar-gap", "default": "var(--shift-gap, calc(var(--_ap-gap, 4px) * var(--_sz-space, 1)))", "description": "Spacing · between day cells" },
          {
            "name": "--shift-calendar-header-gap",
            "default": "max(calc(8px * var(--_sz-space, 1)), calc(var(--_ring) + 2px))",
            "description": "Spacing · between title and buttons"
          },
          {
            "name": "--shift-calendar-heading-font-size",
            "default": "calc(var(--shift-font-size, calc(var(--_ap-font-size, 14px) + var(--_sz-font, 0px))) + 1px)",
            "description": "Type · title size"
          },
          { "name": "--shift-calendar-heading-font-weight", "default": "700", "description": "Type · title weight" },
          { "name": "--shift-calendar-heading-ink", "default": "var(--shift-ink, var(--_ap-ink, #1e293b))", "description": "Colour · month and year title" },
          { "name": "--shift-calendar-heading-line-height", "default": "1.2", "description": "Type · title line height" },
          { "name": "--shift-calendar-ink", "default": "var(--shift-ink, var(--_ap-ink, #1e293b))", "description": "Colour · main text" },
          { "name": "--shift-calendar-line", "default": "var(--shift-line, var(--_ap-line, #e2e8f0))", "description": "Colour · lines at rest" },
          { "name": "--shift-calendar-line-height", "default": "1.35", "description": "Type · base line height" },
          { "name": "--shift-calendar-max-inline-size", "default": "var(--_sz-width, 380px)", "description": "Size · default and widest width" },
          { "name": "--shift-calendar-min-inline-size", "default": "var(--_sz-min-width, 300px)", "description": "Size · narrowest width" },
          { "name": "--shift-calendar-muted", "default": "var(--shift-ink-muted, var(--_ap-ink-muted, #64748b))", "description": "Colour · weekday labels, secondary text" },
          { "name": "--shift-calendar-nav-border", "default": "var(--shift-line, var(--_ap-line, #e2e8f0))", "description": "Colour · header button outline" },
          { "name": "--shift-calendar-nav-gap", "default": "max(calc(4px * var(--_sz-space, 1)), calc(var(--_ring) + 2px))", "description": "Spacing · between header buttons" },
          { "name": "--shift-calendar-nav-hover-bg", "default": "var(--_ap-hover-bg, #f1f5f9)", "description": "Colour · header button on hover" },
          { "name": "--shift-calendar-nav-icon-size", "default": "var(--_sz-icon, 16px)", "description": "Size · arrow icon size" },
          { "name": "--shift-calendar-nav-ink", "default": "var(--shift-ink, var(--_ap-ink, #1e293b))", "description": "Colour · header button icons" },
          { "name": "--shift-calendar-nav-size", "default": "var(--_sz-nav, 32px)", "description": "Size · header button size" },
          { "name": "--shift-calendar-on-accent", "default": "var(--shift-on-accent, var(--_ap-on-accent, #ffffff))", "description": "Colour · text on the selected day" },
          {
            "name": "--shift-calendar-outside-ink",
            "default": "var(--shift-ink-disabled, var(--_ap-ink-disabled, #cbd5e1))",
            "description": "Colour · days of the neighbouring months"
          },
          { "name": "--shift-calendar-padding", "default": "calc(12px * var(--_sz-space, 1))", "description": "Spacing · inside padding" },
          { "name": "--shift-calendar-padding-top", "default": "calc(12px * var(--_sz-space, 1))", "description": "Spacing · padding above the header" },
          { "name": "--shift-calendar-panel-border-width", "default": "var(--_ap-panel-border-width, 1px)", "description": "Shape · calendar outline width" },
          { "name": "--shift-calendar-panel-line", "default": "var(--_ap-panel-line, #e2e8f0)", "description": "Colour · calendar outline" },
          { "name": "--shift-calendar-radius", "default": "var(--shift-radius-lg, var(--_ap-radius-lg, 12px))", "description": "Shape · calendar corner radius" },
          { "name": "--shift-calendar-section-gap", "default": "calc(8px * var(--_sz-space, 1))", "description": "Spacing · between header, weekdays and grid" },
          { "name": "--shift-calendar-settle", "default": "var(--shift-settle, 480ms)", "description": "Motion · duration of every movement" },
          { "name": "--shift-calendar-shadow", "default": "var(--shift-shadow-control, var(--_ap-shadow-control, none))", "description": "Effect · calendar shadow" },
          { "name": "--shift-calendar-surface", "default": "var(--shift-surface, var(--_ap-panel-surface, #ffffff))", "description": "Colour · calendar background" },
          { "name": "--shift-calendar-title-gap", "default": "2px", "description": "Spacing · between year and month" },
          { "name": "--shift-calendar-title-padding-inline", "default": "2px", "description": "Spacing · title button padding" },
          { "name": "--shift-calendar-title-radius", "default": "var(--shift-radius-md, var(--_ap-radius-md, 8px))", "description": "Shape · title button radius" },
          { "name": "--shift-calendar-today-dot", "default": "var(--_ap-today-dot, transparent)", "description": "Colour · today’s dot (with highlightToday)" },
          { "name": "--shift-calendar-today-dot-size", "default": "4px", "description": "Today · dot size" },
          {
            "name": "--shift-calendar-today-font-size",
            "default": "var(--shift-font-size-sm, calc(var(--_ap-font-size-sm, 12px) + var(--_sz-font, 0px)))",
            "description": "Type · Today button label size"
          },
          {
            "name": "--shift-calendar-today-font-weight",
            "default": "var(--shift-weight-strong, var(--_ap-weight-strong, 600))",
            "description": "Type · Today button label weight"
          },
          { "name": "--shift-calendar-today-icon-size", "default": "calc(var(--_sz-icon, 16px) - 2px)", "description": "Size · Today icon size" },
          { "name": "--shift-calendar-today-mark-decoration", "default": "var(--_ap-today-decoration, none)", "description": "Today · number decoration (e.g. underline)" },
          { "name": "--shift-calendar-today-mark-stroke", "default": "var(--_ap-today-stroke, 0px)", "description": "Today · text stroke that bolds the number" },
          { "name": "--shift-calendar-today-padding-inline", "default": "10px", "description": "Spacing · Today button padding" },
          { "name": "--shift-calendar-today-ring", "default": "var(--_ap-today-ring, #64748b)", "description": "Colour · today’s ring (with highlightToday)" },
          { "name": "--shift-calendar-today-ring-width", "default": "var(--_ap-today-ring-width, 1px)", "description": "Today · ring width" },
          { "name": "--shift-calendar-tone-danger-bg", "default": "var(--_ap-tone-danger-bg, #fff1f0)", "description": "Badge · danger background" },
          { "name": "--shift-calendar-tone-danger-ink", "default": "var(--_ap-tone-danger-ink, #9b2c2c)", "description": "Badge · danger text" },
          { "name": "--shift-calendar-tone-info-bg", "default": "var(--_ap-tone-info-bg, #e8f1f8)", "description": "Badge · info background" },
          { "name": "--shift-calendar-tone-info-ink", "default": "var(--_ap-tone-info-ink, #275e8f)", "description": "Badge · info text" },
          { "name": "--shift-calendar-tone-neutral-bg", "default": "var(--_ap-tone-neutral-bg, #e8ecef)", "description": "Badge · neutral background" },
          { "name": "--shift-calendar-tone-neutral-ink", "default": "var(--_ap-tone-neutral-ink, #46535e)", "description": "Badge · neutral text" },
          { "name": "--shift-calendar-tone-success-bg", "default": "var(--_ap-tone-success-bg, #e8f4ed)", "description": "Badge · success background" },
          { "name": "--shift-calendar-tone-success-ink", "default": "var(--_ap-tone-success-ink, #216b44)", "description": "Badge · success text" },
          { "name": "--shift-calendar-tone-warning-bg", "default": "var(--_ap-tone-warning-bg, #fff7e6)", "description": "Badge · warning background" },
          { "name": "--shift-calendar-tone-warning-ink", "default": "var(--_ap-tone-warning-ink, #8a5a12)", "description": "Badge · warning text" },
          {
            "name": "--shift-calendar-tooltip-font-size",
            "default": "var(--shift-font-size-sm, calc(var(--_ap-font-size-sm, 12px) + var(--_sz-font, 0px)))",
            "description": "Type · tooltip size"
          },
          { "name": "--shift-calendar-tooltip-ink", "default": "var(--_ap-tooltip-ink, #f8fafc)", "description": "Colour · tooltip text" },
          { "name": "--shift-calendar-tooltip-radius", "default": "6px", "description": "Shape · tooltip radius" },
          { "name": "--shift-calendar-tooltip-surface", "default": "var(--_ap-tooltip-surface, #1e293b)", "description": "Colour · tooltip background" },
          {
            "name": "--shift-calendar-weekday-font-size",
            "default": "calc(var(--shift-font-size-sm, calc(var(--_ap-font-size-sm, 12px) + var(--_sz-font, 0px))) - 1px)",
            "description": "Type · weekday label size"
          },
          { "name": "--shift-calendar-weekday-font-weight", "default": "700", "description": "Type · weekday label weight" },
          { "name": "--shift-calendar-weekday-line-height", "default": "calc(16px + var(--_sz-font, 0px))", "description": "Type · weekday label line height" },
          { "name": "--shift-calendar-weekday-padding-block", "default": "2px", "description": "Spacing · weekday label padding" },
          { "name": "--shift-calendar-weekday-tracking", "default": "normal", "description": "Type · weekday label letter spacing" },
          { "name": "--shift-calendar-weekday-transform", "default": "none", "description": "Type · weekday label case" }
        ]
      },
      "runtimeAssets": {
        "locales": null,
        "notes": [
          "Takes calendar dates in and gives one out; it makes no requests. A host loads availability on monthChange and passes it back through enabledDates and dayMeta.",
          "Month and weekday names and control labels are bundled for en, ar, ku and ru, so no locale file is fetched.",
          "Rule precedence: range (min/max) → disabledDates → disabledWeekdays → not in enabledDates → isDateDisabled. The first rule that matches is the reason a day is blocked (data-reason on the cell). Rules only ever block: the allow-list never re-enables a day another rule blocked.",
          "Disabled days are focusable but cannot be selected. Inside min/max, the arrow, Home/End and Page keys land on every day of the month, including disabled ones, which carry aria-disabled so a screen-reader user can discover them (the WAI-ARIA APG allows focusable disabled items in composite widgets). Enter and Space do nothing on them. Days of the neighbouring months and days outside min/max are never focused.",
          "A min later than max is an empty range: every day is disabled, the month buttons, Today and the keyboard do not move, and the month stays where it opened unless the host sets month.",
          "Appearance and colour scheme follow the shared appearance rules: every value resolves as --shift-calendar-x, then --shift-x, then the appearance, then the vanilla baseline, so host variables win in light and dark. The component never sets --shift-* itself.",
          "Fonts: Nunito (vanilla, material, soft) or Manrope (sharp, minimal), with Noto Kufi Arabic first for ar and ku — all loaded by the package’s global script. Override with --shift-font-family and --shift-font-family-arabic.",
          "The box never changes size: six rows always, a fixed header band, and the months and years views fill exactly the days view. Only another density (an appearance with a different cell size or gap) or another size resizes it.",
          "Every movement — header roll, day carousel, view slide, year paging — runs on one clock: --shift-calendar-settle (or --shift-settle), 480ms by default; instant under prefers-reduced-motion."
        ]
      }
    },
    {
      "tag": "shift-time-slots",
      "modulePath": "dist/components/shift-time-slots.js",
      "wireContract": null,
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": [
          "times",
          "value",
          "disabledTimes",
          "hourCycle",
          "language",
          "numerals",
          "label",
          "emptyText",
          "loading",
          "skeletonCount",
          "disabled",
          "appearance",
          "colorScheme",
          "size"
        ],
        "methods": ["setFocus"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["time grid rendering", "single-time selection", "keyboard navigation", "loading and empty presentation", "appearance and colour scheme"]
      },
      "api": {
        "props": [
          {
            "name": "appearance",
            "attribute": "appearance",
            "type": "\"material\" | \"minimal\" | \"sharp\" | \"soft\" | \"vanilla\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "vanilla, material, soft, sharp or minimal. Unset renders vanilla."
          },
          {
            "name": "colorScheme",
            "attribute": "color-scheme",
            "type": "\"auto\" | \"dark\" | \"light\"",
            "default": "'light'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "light (default), dark, or auto (follows prefers-color-scheme; for hosts that are themselves dark-aware)."
          },
          {
            "name": "disabled",
            "attribute": "disabled",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "No time can be chosen and none is in the tab order."
          },
          {
            "name": "disabledTimes",
            "attribute": "disabled-times",
            "type": "string | string[]",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Times shown but not selectable, same shapes as times."
          },
          {
            "name": "emptyText",
            "attribute": "empty-text",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Text when there are no times. Default: a localized “no times available on this day”."
          },
          {
            "name": "hourCycle",
            "attribute": "hour-cycle",
            "type": "\"h12\" | \"h23\"",
            "default": "'h23'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "h23 (default) shows 09:00 and 13:00; h12 shows 9:00 AM and 1:00 PM with the language’s own AM and PM."
          },
          {
            "name": "label",
            "attribute": "label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Accessible name for the group. Default: the localized word for times."
          },
          {
            "name": "language",
            "attribute": "language",
            "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"",
            "default": "'en'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "en, ar, ku or ru. Sets direction, digits, the AM and PM words and the messages."
          },
          {
            "name": "loading",
            "attribute": "loading",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "Shows placeholders instead of times and sets aria-busy while the host loads the day."
          },
          {
            "name": "numerals",
            "attribute": "numerals",
            "type": "\"arab\" | \"latn\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "latn or arab. Default by language: Arabic-Indic digits for ar and ku, Latin for en and ru."
          },
          {
            "name": "size",
            "attribute": "size",
            "type": "\"lg\" | \"md\" | \"sm\" | \"xl\" | \"xs\"",
            "default": "'md'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "xs, sm, md (default), lg or xl. Scales the times, type and gaps. md equals no size."
          },
          {
            "name": "skeletonCount",
            "attribute": "skeleton-count",
            "type": "number",
            "default": "8",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "How many placeholders loading shows (1–48). Default 8, one to two rows in most hosts."
          },
          {
            "name": "times",
            "attribute": "times",
            "type": "string | string[]",
            "default": "[]",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "The day’s times as HH:mm: an array, or a comma, space or JSON-array string. Sorted and de-duplicated; anything else is ignored."
          },
          {
            "name": "value",
            "attribute": "value",
            "type": "string",
            "default": "''",
            "mutable": true,
            "required": false,
            "reflect": true,
            "description": "The chosen time, HH:mm, or empty. Set by a pick; a host may set it (no event). A value not in times selects nothing."
          }
        ],
        "methods": [{ "name": "setFocus", "parameters": "() => Promise<void>", "returns": "Promise<void>", "description": "Moves focus to the time in the tab order." }],
        "events": [
          {
            "name": "timeChange",
            "type": "TimeChangeDetail",
            "description": "Detail { value: HH:mm }. Fires on every pick, including the current value again; never for a disabled time or when a host sets value."
          }
        ],
        "dependencies": [],
        "parts": [
          { "name": "root", "description": "The group (role=radiogroup)." },
          { "name": "grid", "description": "The grid of times, or of placeholders while loading." },
          { "name": "time", "description": "Every time. States beside it: time-selected, time-disabled." },
          { "name": "time-selected", "description": "The chosen time." },
          { "name": "time-disabled", "description": "A time that cannot be chosen." },
          { "name": "skeleton", "description": "A loading placeholder." },
          { "name": "empty", "description": "The message shown when there are no times." }
        ],
        "cssProperties": [
          { "name": "--shift-time-slots-accent", "default": "var(--shift-accent, var(--_ap-accent, #1e293b))", "description": "Colour · selected time fill" },
          {
            "name": "--shift-time-slots-blocked-decoration",
            "default": "var(--_ap-blocked-decoration, line-through)",
            "description": "Disabled times · text decoration (e.g. line-through)"
          },
          { "name": "--shift-time-slots-blocked-opacity", "default": "var(--_ap-blocked-opacity, 1)", "description": "Disabled times · opacity" },
          { "name": "--shift-time-slots-border-width", "default": "var(--shift-border-width, var(--_ap-border-width, 1px))", "description": "Shape · time border width" },
          {
            "name": "--shift-time-slots-chip-height",
            "default": "var(--shift-control-height, calc(var(--_ap-control-height, 44px) * var(--_sz-control, 1)))",
            "description": "Size · smallest time height (the touch target)"
          },
          { "name": "--shift-time-slots-chip-padding-inline", "default": "calc(8px * var(--_sz-space, 1))", "description": "Spacing · padding inside a time" },
          { "name": "--shift-time-slots-disabled-ink", "default": "var(--shift-ink-disabled, var(--_ap-ink-disabled, #cbd5e1))", "description": "Colour · disabled times" },
          { "name": "--shift-time-slots-ease", "default": "var(--shift-ease, ease)", "description": "Motion · easing of every movement" },
          {
            "name": "--shift-time-slots-empty-font-size",
            "default": "var(--shift-font-size-sm, calc(var(--_ap-font-size-sm, 12px) + var(--_sz-font, 0px)))",
            "description": "Type · empty message size"
          },
          { "name": "--shift-time-slots-empty-padding-block", "default": "calc(24px * var(--_sz-space, 1))", "description": "Spacing · space above and below the empty message" },
          { "name": "--shift-time-slots-focus-halo", "default": "var(--_ap-focus-halo, transparent)", "description": "Colour · halo around a focused time" },
          { "name": "--shift-time-slots-focus-halo-width", "default": "var(--_ap-focus-halo-width, 0px)", "description": "Focus · halo width" },
          { "name": "--shift-time-slots-focus-ring", "default": "var(--shift-focus, var(--_ap-focus, #1e293b))", "description": "Colour · focus ring" },
          { "name": "--shift-time-slots-focus-ring-offset", "default": "var(--_ap-focus-offset, 2px)", "description": "Focus · gap between a time and its ring" },
          { "name": "--shift-time-slots-focus-ring-width", "default": "var(--_ap-focus-width, 2px)", "description": "Focus · ring width" },
          { "name": "--shift-time-slots-font-family", "default": "var(--shift-font-family, var(--_ap-font, 'Nunito', system-ui, sans-serif))", "description": "Type · Latin font" },
          {
            "name": "--shift-time-slots-font-family-arabic",
            "default": "var(--shift-font-family-arabic, 'Noto Kufi Arabic', var(--_font-latin))",
            "description": "Type · Arabic and Kurdish font"
          },
          {
            "name": "--shift-time-slots-font-size",
            "default": "var(--shift-font-size, calc(var(--_ap-font-size, 14px) + var(--_sz-font, 0px)))",
            "description": "Type · time size"
          },
          { "name": "--shift-time-slots-font-weight", "default": "var(--shift-weight, var(--_ap-weight, 400))", "description": "Type · time weight" },
          { "name": "--shift-time-slots-gap", "default": "var(--shift-gap, calc(var(--_ap-gap, 4px) * 2 * var(--_sz-space, 1)))", "description": "Spacing · between times" },
          { "name": "--shift-time-slots-hover-bg", "default": "var(--_ap-hover-bg, #f1f5f9)", "description": "Colour · time background on hover" },
          { "name": "--shift-time-slots-hover-ink", "default": "var(--_ap-hover-ink, #1e293b)", "description": "Colour · time text on hover" },
          { "name": "--shift-time-slots-hover-line", "default": "var(--shift-line-strong, var(--_ap-hover-line, #94a3b8))", "description": "Colour · time outline on hover" },
          { "name": "--shift-time-slots-ink", "default": "var(--shift-ink, var(--_ap-ink, #1e293b))", "description": "Colour · time text" },
          { "name": "--shift-time-slots-line", "default": "var(--shift-line, var(--_ap-line, #e2e8f0))", "description": "Colour · time outline at rest" },
          { "name": "--shift-time-slots-line-height", "default": "1.43", "description": "Type · line height" },
          { "name": "--shift-time-slots-min-column", "default": "calc(84px * var(--_sz-control, 1))", "description": "Size · narrowest column; as many columns as fit" },
          { "name": "--shift-time-slots-muted", "default": "var(--shift-ink-muted, var(--_ap-ink-muted, #64748b))", "description": "Colour · empty message" },
          { "name": "--shift-time-slots-on-accent", "default": "var(--shift-on-accent, var(--_ap-on-accent, #ffffff))", "description": "Colour · text on the selected time" },
          { "name": "--shift-time-slots-radius", "default": "var(--shift-radius-sm, var(--_ap-radius-sm, 8px))", "description": "Shape · time radius" },
          { "name": "--shift-time-slots-rise-distance", "default": "8px", "description": "Motion · how far arriving times rise" },
          { "name": "--shift-time-slots-selected-font-weight", "default": "var(--shift-weight, var(--_ap-weight, 400))", "description": "Type · selected time weight" },
          { "name": "--shift-time-slots-settle", "default": "var(--shift-settle, 480ms)", "description": "Motion · duration of every movement" },
          { "name": "--shift-time-slots-shadow", "default": "var(--shift-shadow-control, var(--_ap-shadow-control, none))", "description": "Effect · time shadow" },
          {
            "name": "--shift-time-slots-shadow-room",
            "default": "6px",
            "description": "Size · extra room under the last row so raised times keep their whole shadow (default 6px)"
          },
          { "name": "--shift-time-slots-skeleton", "default": "var(--shift-accent-tint, var(--_ap-accent-tint, #f1f5f9))", "description": "Colour · loading placeholder fill" },
          { "name": "--shift-time-slots-surface", "default": "var(--shift-surface, var(--_ap-surface, #ffffff))", "description": "Colour · time background" }
        ]
      },
      "runtimeAssets": {
        "locales": null,
        "notes": [
          "Takes the times of one day in and gives one out; it makes no requests. Times are HH:mm on a 24-hour clock whatever hourCycle shows.",
          "Times sit in as many columns as fit (84px or wider at md), each at least 44px tall, so a narrow host gets fewer columns, never a scrollbar.",
          "Selection follows Enter, Space or a click, not focus: arrows move focus only and pass over disabled times, so moving through the day with the keyboard never picks one. This is the documented difference from the WAI-ARIA radio group, where arrows also check.",
          "When the times change, the outgoing grid fades while the incoming times rise one after another, and the height moves to the new row count on grid-template-rows. Loading shows skeletonCount placeholders the size of a time. Instant under prefers-reduced-motion.",
          "Appearance and colour scheme follow the shared appearance rules: every value resolves as --shift-time-slots-x, then --shift-x, then the appearance, then the vanilla baseline. The component never sets --shift-* itself.",
          "Fonts: Nunito (vanilla, material, soft) or Manrope (sharp, minimal), with Noto Kufi Arabic first for ar and ku, loaded by the package’s global script."
        ]
      }
    },
    {
      "tag": "shift-booking-calendar",
      "modulePath": "dist/components/shift-booking-calendar.js",
      "wireContract": null,
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": [
          "calendarApi",
          "branchId",
          "departmentId",
          "departmentIds",
          "services",
          "brandId",
          "today",
          "disabledWeekdays",
          "disabledDates",
          "slotCounts",
          "hourCycle",
          "labelFormat",
          "dayTitleFormat",
          "name",
          "form",
          "label",
          "isRequired",
          "isDisabled",
          "language",
          "localization",
          "defaultValue",
          "value",
          "valueFormat",
          "utcOffset",
          "changeCallback",
          "wrapperId",
          "wrapperClass",
          "appearance",
          "colorScheme",
          "size"
        ],
        "methods": ["refresh", "setFocus", "getValueLabel", "setBlazorRef"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": [
          "branch availability request",
          "month calendar of open days",
          "times of the chosen day, in the same box",
          "slot selection",
          "form value and validation",
          "appearance and colour scheme"
        ]
      },
      "api": {
        "props": [
          {
            "name": "appearance",
            "attribute": "appearance",
            "type": "\"material\" | \"minimal\" | \"sharp\" | \"soft\" | \"vanilla\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "vanilla, material, soft, sharp or minimal. Unset renders vanilla."
          },
          {
            "name": "branchId",
            "attribute": "branch-id",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "The branch’s hash ID. The field stays idle until branch, department and brand are all set."
          },
          {
            "name": "brandId",
            "attribute": "brand-id",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Brand Integration ID, one value."
          },
          {
            "name": "calendarApi",
            "attribute": "calendar-api",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Full URL of the calendar endpoint. It is called with from, to, branchId, departmentId and brandId."
          },
          {
            "name": "changeCallback",
            "attribute": "change-callback",
            "type": "((value: string, label: string, complete: boolean) => void) | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Called on every pickerChange with (value, label, complete): a function, or the name of a [JSInvokable] method on the Blazor ref set by setBlazorRef. A function set after load, like setBlazorRef, is called once right away with the current value's label."
          },
          {
            "name": "colorScheme",
            "attribute": "color-scheme",
            "type": "\"auto\" | \"dark\" | \"light\"",
            "default": "'light'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "light (default), dark, or auto (follows prefers-color-scheme; for hosts that are themselves dark-aware)."
          },
          {
            "name": "dayTitleFormat",
            "attribute": "day-title-format",
            "type": "\"ar\" | \"en\" | \"ku\" | \"ru\" | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "The chosen day’s title over its times, beside Change date: a date-fns pattern, or one per language, as labelFormat. Unset: the language’s default (English EEE, d MMM; Arabic d MMMM)."
          },
          {
            "name": "dayTooltips",
            "attribute": "day-tooltips",
            "type": "boolean",
            "default": "true",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "On mouse hover or keyboard focus, a day shows its count and its first and last time (e.g. 14 times · 7:30 AM – 10:30 PM); the same text is in its accessible description and in the times header. On by default."
          },
          {
            "name": "defaultValue",
            "attribute": "default-value",
            "type": "string",
            "default": null,
            "mutable": true,
            "required": false,
            "reflect": false,
            "description": "A slot as YYYY-MM-DDTHH:mm: its day is chosen and that time marked when the branch has it; the field still opens on the days. Submitted as is until something is picked."
          },
          {
            "name": "departmentId",
            "attribute": "department-id",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Department Integration ID, e.g. showroom or service-center."
          },
          {
            "name": "departmentIds",
            "type": "string[]",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Several Department Integration IDs, set as a property. Asked in parallel and shown together, each time once and in order; used instead of departmentId."
          },
          {
            "name": "disabledDates",
            "attribute": "disabled-dates",
            "type": "string | string[]",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "One-off dates the deployment does not book, YYYY-MM-DD."
          },
          {
            "name": "disabledWeekdays",
            "attribute": "disabled-weekdays",
            "type": "number[] | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Weekdays the deployment never books, 0 Sunday … 6 Saturday, on top of what the endpoint returns."
          },
          {
            "name": "fewSlots",
            "attribute": "few-slots",
            "type": "number",
            "default": "3",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "At or below this many times a day’s count badge takes the warning tone. Default 3."
          },
          {
            "name": "form",
            "type": "FormHook<unknown>",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "JS property only. The form hook; omit it standalone and listen to slotChange."
          },
          {
            "name": "hourCycle",
            "attribute": "hour-cycle",
            "type": "\"h12\" | \"h23\"",
            "default": "'h23'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "h23 (default) or h12, for the times."
          },
          {
            "name": "isDisabled",
            "attribute": "is-disabled",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Nothing can be chosen."
          },
          {
            "name": "isRequired",
            "attribute": "is-required",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Required. A form hook’s own required rule applies as well."
          },
          {
            "name": "label",
            "attribute": "label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Field label. A form’s localization label wins."
          },
          {
            "name": "labelFormat",
            "attribute": "label-format",
            "type": "\"ar\" | \"en\" | \"ku\" | \"ru\" | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "How the picked slot is labelled (the field’s text, pickerChange’s label, a form’s review step): a date-fns pattern, e.g. EEEE d MMMM · h:mm a, or one per language, e.g. { \"en\": \"EEE d MMM, h:mm a\", \"ar\": \"EEEE d MMMM\" }. Month and day names, AM/PM and digits are the calendar’s own for the language. Unset, or a language it does not cover: the language’s default (English d MMM, HH:mm; Arabic d MMMM، H:mm), with h:mm a under hourCycle h12. An unusable pattern falls back to that default. A label wider than the field ends in an ellipsis."
          },
          {
            "name": "language",
            "attribute": "language",
            "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"",
            "default": "'en'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "en, ar, ku or ru. Direction, names, digits and messages."
          },
          {
            "name": "localization",
            "type": "T",
            "default": "{}",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Per-language label and require texts, as every form field takes."
          },
          {
            "name": "name",
            "attribute": "name",
            "type": "string",
            "default": "'bookingCalendar'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "Field name in the form. Default bookingCalendar."
          },
          {
            "name": "services",
            "attribute": "services",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Service Integration IDs, comma separated, used when no department is set: one request, and the calendar endpoint merges those services' departments. A department wins."
          },
          {
            "name": "showEmptyState",
            "attribute": "show-empty-state",
            "type": "boolean",
            "default": "true",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "When the branch has no times at all, a soft veil over the greyed month with an illustration and “No available slots”, announced politely. On by default; the header keeps working."
          },
          {
            "name": "showLabel",
            "attribute": "show-label",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Shows the label above the calendar. Off by default; a host field shows its own."
          },
          {
            "name": "showStatus",
            "attribute": "show-status",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Shows the status line under the calendar (idle, loading, empty, error, pick a day or a time, selected, invalid). Off by default; pickerStatus carries the same messages to a host."
          },
          {
            "name": "showToday",
            "attribute": "show-today",
            "type": "boolean",
            "default": "true",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Shows the calendar’s Today button. On by default; a branch that never books today can turn it off."
          },
          {
            "name": "size",
            "attribute": "size",
            "type": "\"lg\" | \"md\" | \"sm\" | \"xl\" | \"xs\"",
            "default": "'md'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "xs, sm, md (default), lg or xl. Scales the times, type and gaps. md equals no size."
          },
          {
            "name": "slotCounts",
            "attribute": "slot-counts",
            "type": "boolean",
            "default": "true",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Shows each open day’s number of times as a badge under the number, in the warning tone when it has fewSlots or fewer. On by default."
          },
          {
            "name": "today",
            "attribute": "today",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "YYYY-MM-DD that stands in for today: the request starts here. Empty: the visitor’s local date."
          },
          {
            "name": "utcOffset",
            "attribute": "utc-offset",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "The branch's offset, e.g. +03:00: written into an ISO value, and the offset an ISO value in another offset is moved to when read. No default: when unset, ISO values carry no offset and are read as written."
          },
          {
            "name": "value",
            "attribute": "value",
            "type": "string",
            "default": "''",
            "mutable": true,
            "required": false,
            "reflect": false,
            "description": "The current value, written in valueFormat. Settable in ISO (any offset) or in valueFormat: a time the branch has is chosen; any other readable value is kept and labelled; empty clears. The calendar clears it itself only when the branch, department or brand changes after it was set."
          },
          {
            "name": "valueFormat",
            "attribute": "value-format",
            "type": "string",
            "default": "'iso'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "How value and pickerChange's value are written. iso (default): 2026-10-08T15:00:00, plus utcOffset when set (2026-10-08T15:00:00+03:00). Or a pattern of yyyy, MM, dd, HH, hh, mm, ss and tt (AM/PM), e.g. yyyy-MM-dd HH:mm."
          },
          {
            "name": "wrapperClass",
            "attribute": "wrapper-class",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Extra class on the field’s root."
          },
          {
            "name": "wrapperId",
            "attribute": "wrapper-id",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "id for the field’s root."
          }
        ],
        "methods": [
          { "name": "clear", "parameters": "() => Promise<void>", "returns": "Promise<void>", "description": "Clears the chosen day and time without reloading." },
          {
            "name": "getValueLabel",
            "parameters": "() => Promise<string>",
            "returns": "Promise<string>",
            "description": "The localized display text of the current value, the same as pickerChange's label, also for a value that is not a time. For a host that attaches after the calendar has loaded."
          },
          {
            "name": "refresh",
            "parameters": "() => Promise<void>",
            "returns": "Promise<void>",
            "description": "Loads the branch again; the page cache still answers a request it already holds."
          },
          {
            "name": "setBlazorRef",
            "parameters": "(newBlazorRef: DotNetObjectReference) => Promise<void>",
            "returns": "Promise<void>",
            "description": "Blazor hosts: pass a DotNetObjectReference (through the global blazorInvoke). changeCallback then names a method on it, and it is called once right away with the current value's label when there is one."
          },
          {
            "name": "setFocus",
            "parameters": "() => Promise<void>",
            "returns": "Promise<void>",
            "description": "Moves focus into the view on screen: the calendar's day, or the times."
          }
        ],
        "events": [
          {
            "name": "pickerChange",
            "type": "PickerChangeDetail",
            "description": "The headless picker contract. Detail { value: in valueFormat, label: the localized day and time, complete }. complete is true when a time is picked. With complete false it reports the label of a value the host set (on load too, and for a value that is not a time), a kept time on another day, a language or format change, and a clear after a branch, company, department or brand change (value \"\", label \"\")."
          },
          {
            "name": "pickerStatus",
            "type": "PickerStatusDetail",
            "description": "Detail { text, busy }. The localized loading or failure message a host shows or announces (busy while loading); empty when ready, idle or empty — empty is shown inside the picker."
          },
          {
            "name": "slotChange",
            "type": "BranchSlotSelection",
            "description": "Detail { date: YYYY-MM-DD, raw: the endpoint’s text, value: YYYY-MM-DDTHH:mm }, identical to branch-slot-picker. Fires when a time is picked, and when a reopened day keeps the chosen time."
          }
        ],
        "dependencies": ["shift-calendar", "shift-time-slots"],
        "parts": [
          { "name": "root", "description": "The field." },
          { "name": "label", "description": "The field label." },
          { "name": "required", "description": "The required mark." },
          { "name": "box", "description": "The fixed box holding both views." },
          { "name": "calendar", "description": "The shift-calendar element (the days view)." },
          { "name": "times", "description": "The times view, laid over the calendar." },
          { "name": "times-header", "description": "The times view's header." },
          { "name": "times-heading", "description": "The chosen day in the header." },
          { "name": "times-time", "description": "The chosen time beside the day." },
          { "name": "back", "description": "The Change date button." },
          { "name": "times-body", "description": "The region holding the times; scrolls when a day has many." },
          { "name": "slots", "description": "The shift-time-slots element." },
          { "name": "status", "description": "The row under the box: what to do next, the chosen slot, why there is nothing to choose, or the validation message." },
          { "name": "status-text", "description": "The text in the status row. status-error sits beside it on the error message." },
          { "name": "status-error", "description": "The load error text in the status row." },
          { "name": "retry", "description": "The Try again button." },
          { "name": "error", "description": "The validation message, in the status row." },
          { "name": "times-summary", "description": "The day’s count and time range under the date in the times header." },
          { "name": "empty", "description": "The empty-state veil over the grid (illustration and message)." }
        ],
        "cssProperties": [
          {
            "name": "--shift-booking-calendar-back-font-weight",
            "default": "var(--shift-weight-strong, var(--_ap-weight-strong, 600))",
            "description": "Type · Change date label weight"
          },
          { "name": "--shift-booking-calendar-back-gap", "default": "calc(6px * var(--_sz-space, 1))", "description": "Spacing · between the chevron and the Change date label" },
          { "name": "--shift-booking-calendar-back-icon-size", "default": "var(--_sz-icon, 16px)", "description": "Size · Change date chevron" },
          { "name": "--shift-booking-calendar-back-padding-inline", "default": "10px", "description": "Spacing · Change date button side padding" },
          {
            "name": "--shift-booking-calendar-border-width",
            "default": "var(--shift-border-width, var(--_ap-border-width, 1px))",
            "description": "Shape · Change date and retry button border width"
          },
          {
            "name": "--shift-booking-calendar-button-radius",
            "default": "var(--shift-radius-md, var(--_ap-radius-md, 8px))",
            "description": "Shape · Change date and retry button radius"
          },
          { "name": "--shift-booking-calendar-danger", "default": "var(--shift-danger, var(--_ap-danger, #dc2626))", "description": "Colour · required mark, errors" },
          { "name": "--shift-booking-calendar-ease", "default": "var(--shift-ease, ease)", "description": "Motion · easing of the view switch and messages" },
          { "name": "--shift-booking-calendar-empty-art-size", "default": "calc(56px * var(--_sz-control, 1))", "description": "Size · the empty-state illustration" },
          {
            "name": "--shift-booking-calendar-empty-veil",
            "default": "color-mix(in srgb, var(--shift-surface, var(--_ap-panel-surface, #ffffff)) 72%, transparent)",
            "description": "Colour · the translucent layer over the greyed grid when there are no times"
          },
          { "name": "--shift-booking-calendar-focus-halo", "default": "var(--_ap-focus-halo, transparent)", "description": "Focus · halo colour around a focused button" },
          { "name": "--shift-booking-calendar-focus-halo-width", "default": "var(--_ap-focus-halo-width, 0px)", "description": "Focus · halo width" },
          {
            "name": "--shift-booking-calendar-focus-ring",
            "default": "var(--shift-focus, var(--_ap-focus, #1e293b))",
            "description": "Colour · Change date and retry button focus ring"
          },
          { "name": "--shift-booking-calendar-focus-ring-offset", "default": "var(--_ap-focus-offset, 2px)", "description": "Focus · gap between a button and its ring" },
          { "name": "--shift-booking-calendar-focus-ring-width", "default": "var(--_ap-focus-width, 2px)", "description": "Focus · ring width" },
          {
            "name": "--shift-booking-calendar-font-family",
            "default": "var(--shift-font-family, var(--_ap-font, 'Nunito', system-ui, sans-serif))",
            "description": "Type · Latin font"
          },
          {
            "name": "--shift-booking-calendar-font-family-arabic",
            "default": "var(--shift-font-family-arabic, 'Noto Kufi Arabic', var(--_font-latin))",
            "description": "Type · Arabic and Kurdish font"
          },
          {
            "name": "--shift-booking-calendar-font-size",
            "default": "var(--shift-font-size, calc(var(--_ap-font-size, 14px) + var(--_sz-font, 0px)))",
            "description": "Type · base size"
          },
          { "name": "--shift-booking-calendar-gap", "default": "calc(12px * var(--_sz-space, 1))", "description": "Spacing · between label, box and status row" },
          { "name": "--shift-booking-calendar-heading-ink", "default": "var(--shift-ink, var(--_ap-ink, #1e293b))", "description": "Colour · the day in the times header" },
          { "name": "--shift-booking-calendar-hover-bg", "default": "var(--_ap-hover-bg, #f1f5f9)", "description": "Colour · Change date and retry button on hover" },
          { "name": "--shift-booking-calendar-ink", "default": "var(--shift-ink, var(--_ap-ink, #1e293b))", "description": "Colour · label and chosen slot" },
          {
            "name": "--shift-booking-calendar-label-font-size",
            "default": "var(--shift-label-size, calc(var(--_ap-label-size, 12px) + var(--_sz-font, 0px)))",
            "description": "Type · label size"
          },
          { "name": "--shift-booking-calendar-label-font-weight", "default": "var(--shift-weight-strong, var(--_ap-label-weight, 600))", "description": "Type · label weight" },
          {
            "name": "--shift-booking-calendar-label-tracking",
            "default": "var(--shift-label-tracking, var(--_ap-label-tracking, 0.04em))",
            "description": "Type · label letter spacing"
          },
          {
            "name": "--shift-booking-calendar-label-transform",
            "default": "var(--shift-label-transform, var(--_ap-label-transform, uppercase))",
            "description": "Type · label case"
          },
          { "name": "--shift-booking-calendar-line", "default": "var(--shift-line, var(--_ap-line, #e2e8f0))", "description": "Colour · Change date and retry button outline" },
          { "name": "--shift-booking-calendar-line-height", "default": "1.4", "description": "Type · base line height" },
          { "name": "--shift-booking-calendar-max-inline-size", "default": "var(--_sz-width, 380px)", "description": "Size · default and widest width" },
          { "name": "--shift-booking-calendar-min-inline-size", "default": "var(--_sz-min-width, 300px)", "description": "Size · declared minimum width" },
          { "name": "--shift-booking-calendar-muted", "default": "var(--shift-ink-muted, var(--_ap-ink-muted, #64748b))", "description": "Colour · status messages" },
          {
            "name": "--shift-booking-calendar-scroll-end-room",
            "default": "6px",
            "description": "Size · extra room at the end of the times list so the last row's shadow is not clipped (default 6px)"
          },
          { "name": "--shift-booking-calendar-settle", "default": "var(--shift-settle, 480ms)", "description": "Motion · duration of the view switch and messages" },
          { "name": "--shift-booking-calendar-spinner-size", "default": "var(--_sz-icon, 16px)", "description": "Size · loading spinner" },
          {
            "name": "--shift-booking-calendar-status-font-size",
            "default": "var(--shift-font-size-sm, calc(var(--_ap-font-size-sm, 12px) + var(--_sz-font, 0px)))",
            "description": "Type · status message size"
          },
          { "name": "--shift-booking-calendar-status-font-weight", "default": "var(--shift-weight, var(--_ap-weight, 400))", "description": "Type · status message weight" },
          { "name": "--shift-booking-calendar-status-min-block-size", "default": "calc(32px * var(--_sz-control, 1))", "description": "Size · height of the status row" }
        ]
      },
      "runtimeAssets": {
        "locales": null,
        "notes": [
          "One request per branch, from today: the endpoint’s booking delay counts from the request’s from date, so the field never pages forward. The days shown are whatever the response holds; days without times are dropped.",
          "In a v1 form structure (type bookingCalendar) departmentPreference lists the departments it may book, in order (default [\"showroom\"]). A branch with none of them is not bookable: the field is disabled and its hint says so (booking locale branchUnavailable, or the node’s localization[lang].branchUnavailable). It never falls back to another department, whose hours would look bookable but be the wrong ones. With mergeDepartments: true it asks every listed department the branch has, in parallel, and shows their times together, each once and in order. An explicit departmentId still wins. The older bookingSlot and bookingDate fields still fall back to the branch’s first department.",
          "Responses are cached per branch, department, brand, language and day for the page’s lifetime; errors are not cached and nothing retries on its own. A stale request is cancelled when the branch changes.",
          "The submitted value and the slotChange detail are exactly branch-slot-picker’s: value YYYY-MM-DDTHH:mm, detail { date, raw, value } with raw as the endpoint sent it.",
          "States: idle (no branch yet), loading, ready, empty (no times at the branch) and error (with Try again). No day is chosen on load; the calendar opens on the month of the first open day. Reopening a day keeps the chosen time when that day has it, otherwise clears it.",
          "The calendar owns its value. A value that is not one of the branch's times (a past booking, or one made elsewhere) is kept and labelled, never cleared by the calendar. The value is cleared only when branchId, departmentId or brandId changes after it was set: an id filled in for the first time is not a change, and neither is a host setting an id and the value in the same pass (a record loaded into the form). calendarApi and today changing keep it. A clear fires pickerChange with value \"\" and complete false.",
          "Hosting with your own input: <shift-popover anchor=\"#input\" placement=\"top\" appearance=\"material\" size=\"sm\"> around <shift-booking-calendar appearance=\"material\" size=\"sm\">. Toggle the popover on the input's click, show pickerChange's label in the input and store its value; the popover closes itself when a time is picked. The calendar stays a separate element because the popover carries its content onto <body> and the calendar's views live in its own shadow root; shift-input type picker is the one-element field for pages that use shift-input.",
          "Two views in one box: picking an open day switches from the days to that day's times, the header rolling from the month to the day and the content sliding toward the start (mirrored in RTL). Change date or Escape reverses it. The box keeps the calendar's size in both views and every state; a long day scrolls inside it. Nothing below the field moves: the status row has a fixed height and also carries the validation message.",
          "Inside the field the calendar always fills the box; --shift-booking-calendar-max-inline-size and -min-inline-size set its width.",
          "appearance, colorScheme and size pass to the calendar and the times; host --shift-* variables reach both, since they inherit."
        ]
      }
    },
    {
      "tag": "shift-popover",
      "modulePath": "dist/components/shift-popover.js",
      "wireContract": null,
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": ["anchor", "open", "label", "offset", "trigger", "disabled", "placement", "mobileSheet", "alwaysSheet", "language", "appearance", "colorScheme", "size"],
        "methods": ["show", "hide", "toggle"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["portaled panel holding the slotted content", "anchored positioning and bottom sheet", "dismissal and focus return", "appearance and colour scheme of the panel"]
      },
      "api": {
        "props": [
          {
            "name": "align",
            "attribute": "align",
            "type": "\"end\" | \"start\"",
            "default": "'start'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "start (default) or end: which edge of the anchor the floating panel lines up with. Ignored in a bottom sheet."
          },
          {
            "name": "alwaysSheet",
            "attribute": "always-sheet",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Off (default). On: the panel is a bottom sheet with a backdrop at every width, whatever mobileSheet says. A select with selectDrawer always opens its options this way."
          },
          {
            "name": "anchor",
            "attribute": "anchor",
            "type": "HTMLElement | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "The element the panel hangs from, or a CSS selector (looked up in the popover’s own tree, then the document). Any element on the page, including an input that is not ours."
          },
          {
            "name": "anchorAria",
            "attribute": "anchor-aria",
            "type": "boolean",
            "default": "true",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "On (default): the popover sets aria-haspopup, aria-expanded and aria-controls on its anchor. Off: it leaves them to the anchor's owner, which renders them itself."
          },
          {
            "name": "appearance",
            "attribute": "appearance",
            "type": "\"material\" | \"minimal\" | \"sharp\" | \"soft\" | \"vanilla\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "vanilla, material, soft, sharp or minimal. Unset renders vanilla."
          },
          {
            "name": "colorScheme",
            "attribute": "color-scheme",
            "type": "\"auto\" | \"dark\" | \"light\"",
            "default": "'light'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "light (default), dark, or auto (follows prefers-color-scheme; for hosts that are themselves dark-aware)."
          },
          {
            "name": "disabled",
            "attribute": "disabled",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "Keeps it shut: closes it when set while open, and show(), toggle() and the anchor trigger do nothing. It is also shut while the anchor's input (the anchor itself, or the first input, textarea or select inside it) is disabled or aria-disabled."
          },
          {
            "name": "inside",
            "attribute": "inside",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "A CSS selector. A pointer-down or focus on a matching element elsewhere on the page (a viewer opened from the content) counts as inside and leaves the panel open. Unset by default."
          },
          {
            "name": "label",
            "attribute": "label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Accessible name of the dialog. Without it the dialog is named after its anchor, else “Pop-up” in language."
          },
          {
            "name": "language",
            "attribute": "language",
            "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"",
            "default": "'en'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "en, ar, ku or ru. Language of the default dialog name."
          },
          {
            "name": "mobileSheet",
            "attribute": "mobile-sheet",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Off (default): the panel stays anchored at every width. On: under 600px of viewport width it becomes a bottom sheet with a backdrop. Leave it off for pages shown inside an app’s webview."
          },
          {
            "name": "offset",
            "attribute": "offset",
            "type": "number",
            "default": "8",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Gap between the anchor and the panel, in pixels. 8 by default."
          },
          {
            "name": "open",
            "attribute": "open",
            "type": "boolean",
            "default": "false",
            "mutable": true,
            "required": false,
            "reflect": true,
            "description": "Whether the panel is open. Reflected and mutable. Set it, or use show(), hide() and toggle()."
          },
          {
            "name": "placement",
            "attribute": "placement",
            "type": "\"bottom\" | \"top\"",
            "default": "'bottom'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "The preferred side. bottom (default): below the anchor, above when only above has room. top: above the anchor, below when only below has room. With room on neither side it takes the larger one and the content scrolls. The bottom sheet (mobileSheet, under 600px) is the same for both."
          },
          {
            "name": "size",
            "attribute": "size",
            "type": "\"lg\" | \"md\" | \"sm\" | \"xl\" | \"xs\"",
            "default": "'md'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "xs, sm, md (default), lg or xl. md equals no size."
          },
          {
            "name": "trigger",
            "attribute": "trigger",
            "type": "\"anchor\" | \"manual\"",
            "default": "'manual'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "manual (default): the host opens it with show() or toggle(). anchor: a click on the anchor toggles it, and Enter, Space or ArrowDown on it open it."
          }
        ],
        "methods": [
          { "name": "hide", "parameters": "() => Promise<void>", "returns": "Promise<void>", "description": "Closes the panel. Focus inside the panel returns to the anchor." },
          {
            "name": "show",
            "parameters": "(options?: PopoverShowOptions) => Promise<void>",
            "returns": "Promise<void>",
            "description": "Opens the panel and focuses the content. show({ focus: false }) leaves focus where it is. Called while open, it moves focus into the content."
          },
          {
            "name": "toggle",
            "parameters": "(options?: PopoverShowOptions) => Promise<void>",
            "returns": "Promise<void>",
            "description": "Opens or closes the panel. Ignored for the click that follows a pointer-down which just dismissed it."
          }
        ],
        "events": [
          {
            "name": "openChange",
            "type": "PopoverOpenChangeDetail",
            "description": "Detail { open }. Fires whenever the panel opens or closes: by method, by attribute or by dismissal."
          },
          {
            "name": "sheetChange",
            "type": "PopoverSheetChangeDetail",
            "description": "Detail { sheet }. Fires when the panel becomes a bottom sheet or stops being one (mobileSheet and the viewport, or alwaysSheet), and once on connect when it starts as one. Does not bubble."
          }
        ],
        "dependencies": ["shift-popover-panel", "shift-portal"],
        "parts": [
          { "name": "panel", "description": "The portaled panel. Style it as shift-popover-panel::part(panel), or through a class given to the popover." },
          { "name": "sheet", "description": "State part beside panel while it is a bottom sheet (mobileSheet, viewport under 600px)." },
          { "name": "backdrop", "description": "The overlay behind a bottom sheet; tapping it closes the sheet. Sheet mode only." }
        ],
        "cssProperties": [
          {
            "name": "--shift-popover-backdrop",
            "default": "rgba(15, 23, 42, 0.45)",
            "description": "Colour · the overlay behind a bottom sheet (phones); dark in the dark scheme"
          },
          {
            "name": "--shift-popover-backdrop-blur",
            "default": "4px",
            "description": "Effect · how much the page behind a bottom sheet blurs; none where backdrop-filter is unsupported"
          },
          { "name": "--shift-popover-border-width", "default": "var(--_ap-panel-border-width, 1px)", "description": "Shape · panel border width" },
          { "name": "--shift-popover-ease", "default": "var(--shift-ease, cubic-bezier(0.2, 0, 0, 1))", "description": "Motion · easing of open and close" },
          { "name": "--shift-popover-lift", "default": "6px", "description": "Motion · how far the panel travels as it opens" },
          { "name": "--shift-popover-line", "default": "var(--_ap-panel-line, #e2e8f0)", "description": "Colour · panel border" },
          { "name": "--shift-popover-radius", "default": "var(--shift-radius-lg, var(--_ap-radius-lg, 12px))", "description": "Shape · panel corner radius" },
          { "name": "--shift-popover-scale", "default": "0.96", "description": "Motion · scale the panel grows from" },
          { "name": "--shift-popover-settle", "default": "var(--shift-settle, 320ms)", "description": "Motion · duration of open and close" },
          {
            "name": "--shift-popover-shadow",
            "default": "var(--shift-shadow-panel, var(--_ap-popover-shadow, var(--_ap-shadow-panel, 0 10px 30px -12px rgba(15, 23, 42, 0.25))))",
            "description": "Colour · panel shadow"
          },
          {
            "name": "--shift-popover-sheet-closed-offset",
            "default": "0px",
            "description": "Length · how far below its resting place a bottom sheet sits while closed; 0px by default"
          },
          { "name": "--shift-popover-sheet-max-block-size", "default": "82dvh", "description": "Size · tallest the bottom sheet may get" },
          { "name": "--shift-popover-sheet-radius", "default": "0", "description": "Length · radius of a bottom sheet’s top corners; 0 by default" },
          {
            "name": "--shift-popover-surface",
            "default": "var(--shift-surface, var(--_ap-popover-surface, var(--_ap-panel-surface, #ffffff)))",
            "description": "Colour · panel background"
          },
          { "name": "--shift-popover-width", "default": "max-content", "description": "Size · panel width; the content’s own width by default" },
          { "name": "--shift-popover-z-index", "default": "2000", "description": "Other · stacking order of the panel" }
        ]
      },
      "runtimeAssets": {
        "locales": null,
        "notes": [
          "The content is slotted: the children of shift-popover move into a shift-popover-panel element that shift-portal appends to <body>, so no overflow or stacking context on the page clips them. Keep references to your content elements; do not look them up inside the popover after it loads. Children added later move too.",
          "The panel receives the popover’s appearance, color-scheme and size attributes and its classes. It inherits nothing else from where the popover sits: the --shift-popover-* variables are read on the popover and carried over to the panel, so they may be set anywhere above it, even inside a shadow root; other --shift-* variables go on :root or on a class you give the popover.",
          "Positioning, placement bottom (default): below the anchor, aligned to its inline start (its right edge in RTL, from the anchor’s computed direction); above when there is no room below. It never covers the anchor: when neither side has room it takes the larger side and caps its height to it, and the content scrolls inside the panel. Shifted sideways to stay 8px inside the viewport; re-placed on scroll of any ancestor, on resize and when the anchor or the content resizes. It never scrolls the page. When the anchor scrolls out of sight the panel closes. placement top is the mirror: above the anchor, below when only below has room, and the larger side when neither has.",
          "With mobileSheet, under 600px of viewport width the panel is a bottom sheet whatever the placement: full width, at most 82dvh, sliding up from the bottom edge. Off by default, so the panel stays anchored at every width: a page inside an app’s webview fills only part of the screen, and a sheet there would sit at the bottom of the webview and dim only the webview.",
          "Dismissal: pointer-down outside the panel and the anchor, Escape (focus returns to the anchor), Tab out of the panel (Shift+Tab from its first control returns to the anchor; Tab from its last moves to the control after the anchor), focus moving to any element that is neither the anchor nor a popover panel, a pickerChange with complete true from the content (a time or date picked in shift-booking-calendar or shift-calendar), and hide() from the content.",
          "Focus on open: content with a setFocus() method (shift-calendar has one) is asked to focus itself; otherwise the first control in the content gets focus. show({ focus: false }) leaves focus where it is.",
          "Wire a separate trigger button to toggle(): the pointer-down on it closes an open panel and the click that follows is ignored, so the button closes rather than reopens.",
          "A non-modal popup (WAI-ARIA APG): the body-level shift-popover-panel element is the role=dialog and carries the id. On the anchor the popover sets aria-haspopup=dialog, and aria-controls pointing at that id whenever the anchor is in the document tree (an anchor inside a shadow root gets none, because an IDREF cannot cross the shadow boundary). It never sets or changes the anchor’s role: aria-expanded is set only when the anchor’s role allows it (a button, a combobox, or an element whose implicit role is button), so a foreign input that manages its own ARIA, such as a MudBlazor field, keeps it. shift-input’s own date input is a combobox. What the popover set is removed when the anchor changes.",
          "The dialog always has a name: label; else, when the anchor is in the document tree and has a name of its own, aria-labelledby. For a form control (input, textarea, select) it points at the control’s name sources, never at the control, whose value would become the name: its aria-labelledby ids, else its <label> elements, except that when any label wraps the control the dialog gets the labels’ text as aria-label, with the control’s own contribution left out; a control with only aria-label gives the dialog that text, refreshed on every show(). Any other anchor, such as a button, is referenced itself. Ids the popover adds are removed again on cleanup. Otherwise the anchor’s aria-label or label text; else the localized “Pop-up”.",
          "Several popovers can be open at once. show() on one closes another only when both share the same anchor, and focus moving into another popover’s panel does not close this one. A pointer-down outside a panel and its anchor still closes it.",
          "Open grows and fades from the anchor edge, the sheet slides up; closing reverses. One duration, --shift-popover-settle (or --shift-settle), 320ms by default; instant under prefers-reduced-motion. The panel is position: fixed and never shifts the page layout.",
          "The panel draws the chrome: surface, border, radius and panel shadow from the appearance. A shift-calendar in it draws none of its own and takes its size’s width; the page can still override both. minimal has no opaque surface or panel shadow in appearances.css; the panel fills them in until the shared tokens carry them."
        ]
      }
    },
    {
      "tag": "shift-input",
      "modulePath": "dist/components/shift-input.js",
      "wireContract": null,
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": [
          "type",
          "name",
          "value",
          "defaultValue",
          "label",
          "placeholder",
          "hint",
          "isRequired",
          "isDisabled",
          "readonly",
          "clearable",
          "autocomplete",
          "inputmode",
          "errorMessage",
          "form",
          "language",
          "localization",
          "appearance",
          "colorScheme",
          "size",
          "mobileSheet",
          "format",
          "openOnControlClick",
          "month",
          "min",
          "max",
          "enabledDates",
          "disabledDates",
          "disabledWeekdays",
          "isDateDisabled",
          "dayMeta",
          "today",
          "highlightToday",
          "weekStartsOn",
          "numerals",
          "disableViews",
          "showToday",
          "busy"
        ],
        "methods": ["setFocus"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": [
          "field rendering: label, control, prefix and suffix slots, clear, hint and error",
          "typed entry per type",
          "form field contract",
          "type=\"date\": a shift-popover holding shift-calendar"
        ]
      },
      "api": {
        "props": [
          {
            "name": "appearance",
            "attribute": "appearance",
            "type": "\"material\" | \"minimal\" | \"sharp\" | \"soft\" | \"vanilla\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "vanilla, material, soft, sharp or minimal. Unset renders vanilla."
          },
          {
            "name": "autocomplete",
            "attribute": "autocomplete",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "The input’s autocomplete. Off by default."
          },
          {
            "name": "busy",
            "attribute": "busy",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "The host is loading availability: days dim and cannot be chosen. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "clearable",
            "attribute": "clearable",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Shows a clear button while there is a value. Off by default."
          },
          {
            "name": "colorScheme",
            "attribute": "color-scheme",
            "type": "\"auto\" | \"dark\" | \"light\"",
            "default": "'light'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "light (default), dark, or auto (follows prefers-color-scheme; for hosts that are themselves dark-aware)."
          },
          {
            "name": "dayMeta",
            "attribute": "day-meta",
            "type": "string | { [x: string]: CalendarDayMeta; }",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Per-day badge, tone and description keyed by YYYY-MM-DD. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "defaultValue",
            "attribute": "default-value",
            "type": "string",
            "default": null,
            "mutable": true,
            "required": false,
            "reflect": false,
            "description": "Initial value, and what reset() returns to."
          },
          {
            "name": "disableViews",
            "attribute": "disable-views",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Turns the calendar’s month and year views off. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "disabledDates",
            "attribute": "disabled-dates",
            "type": "string | string[]",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Dates that cannot be chosen or typed. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "disabledWeekdays",
            "attribute": "disabled-weekdays",
            "type": "number[] | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Weekdays that cannot be chosen or typed, 0 Sunday … 6 Saturday. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "enabledDates",
            "attribute": "enabled-dates",
            "type": "string | string[]",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Allow-list of YYYY-MM-DD. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "errorMessage",
            "attribute": "error-message",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "An error to show when used standalone. Typed-entry and form errors take precedence."
          },
          {
            "name": "form",
            "type": "FormHook<Record<string, unknown>>",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "The FormHook that owns the field. Omit it for standalone use and listen to valueChange."
          },
          {
            "name": "format",
            "attribute": "format",
            "type": "string",
            "default": "'dd/MM/yyyy'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "type=\"date\": display and typing format. Default dd/MM/yyyy. Tokens d, dd, M, MM, yyyy in any order with any separators; anything else falls back to the default."
          },
          {
            "name": "highlightToday",
            "attribute": "highlight-today",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Marks today visually. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "hint",
            "attribute": "hint",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "A line of help under the control, in the reserved support line. The error takes its place while there is one."
          },
          {
            "name": "inputmode",
            "attribute": "inputmode",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "The input’s inputmode. Default by type: text, or numeric for date."
          },
          {
            "name": "isDateDisabled",
            "type": "(date: string) => boolean",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "JS property only. (date) => boolean for any other rule. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "isDisabled",
            "attribute": "is-disabled",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Disables the field."
          },
          {
            "name": "isRequired",
            "attribute": "is-required",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Marks the field required when used standalone; inside a form the schema decides."
          },
          {
            "name": "label",
            "attribute": "label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Field label. Inside a form the structure’s localized label wins."
          },
          {
            "name": "language",
            "attribute": "language",
            "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"",
            "default": "'en'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "en, ar, ku or ru. Sets direction, labels and messages, and the calendar’s language."
          },
          {
            "name": "localization",
            "type": "{ hint?: string; unavailableMessage?: string; }",
            "default": "{}",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Per-language overrides: { [lang]: { label, placeholder, hint, require, format, minMessage, maxMessage, unavailableMessage } }."
          },
          {
            "name": "max",
            "attribute": "max",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Latest date (inclusive), YYYY-MM-DD; later typed dates are refused. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "min",
            "attribute": "min",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Earliest date (inclusive), YYYY-MM-DD; earlier typed dates are refused. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "mobileSheet",
            "attribute": "mobile-sheet",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Passed to the field’s popover: on, the calendar or picker opens as a bottom sheet under 600px of viewport width. Off by default; leave it off for pages shown inside an app’s webview."
          },
          {
            "name": "month",
            "attribute": "month",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Month the calendar opens on, YYYY-MM. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "name",
            "attribute": "name",
            "type": "string",
            "default": "''",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "Field name, reflected so the form finds the field. Required inside a form."
          },
          {
            "name": "numerals",
            "attribute": "numerals",
            "type": "\"arab\" | \"latn\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "latn or arab digits in the calendar. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "openOnControlClick",
            "attribute": "open-on-control-click",
            "type": "boolean",
            "default": "true",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "type=\"date\": open the calendar when the input is clicked. On by default."
          },
          {
            "name": "placeholder",
            "attribute": "placeholder",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Input placeholder. Default for date: the format written with localized letters, e.g. dd/mm/yyyy."
          },
          {
            "name": "readonly",
            "attribute": "readonly",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "The value can be read and selected but not changed; no clear and no calendar."
          },
          {
            "name": "showToday",
            "attribute": "show-today",
            "type": "boolean",
            "default": "true",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Shows the calendar’s Today button. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "size",
            "attribute": "size",
            "type": "\"lg\" | \"md\" | \"sm\" | \"xl\" | \"xs\"",
            "default": "'md'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "xs, sm, md (default), lg or xl. md equals no size."
          },
          {
            "name": "today",
            "attribute": "today",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "YYYY-MM-DD that stands in for today. Passed to the calendar (type=\"date\")."
          },
          {
            "name": "type",
            "attribute": "type",
            "type": "\"date\" | \"text\"",
            "default": "'text'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "text (default) or date. Reflected."
          },
          {
            "name": "value",
            "attribute": "value",
            "type": "string",
            "default": "''",
            "mutable": true,
            "required": false,
            "reflect": true,
            "description": "The committed value: text as typed, or YYYY-MM-DD for date. Reflected and mutable."
          },
          {
            "name": "weekStartsOn",
            "attribute": "week-starts-on",
            "type": "number",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "First weekday column, 0 Sunday … 6 Saturday. Passed to the calendar (type=\"date\")."
          }
        ],
        "methods": [{ "name": "setFocus", "parameters": "() => Promise<void>", "returns": "Promise<void>", "description": "Focuses the input." }],
        "events": [
          { "name": "inputBlur", "type": "void", "description": "The input lost focus, after typed text was read." },
          { "name": "inputFocus", "type": "void", "description": "The input received focus." },
          {
            "name": "monthChange",
            "type": "CalendarMonthChangeDetail",
            "description": "type=\"date\": the calendar’s monthChange, forwarded. Detail { month, firstDate, lastDate }."
          },
          {
            "name": "valueChange",
            "type": "InputValueChangeDetail",
            "description": "Detail { value }. Fires when the committed value changes: typed text read on blur or Enter, a day chosen, or cleared. Empty when typed text is refused."
          }
        ],
        "dependencies": ["shift-popover"],
        "parts": [
          { "name": "root", "description": "The field box." },
          { "name": "label", "description": "The label." },
          { "name": "required", "description": "The required mark inside the label." },
          { "name": "control", "description": "The box holding prefix, input and suffix; carries the border and the focus ring." },
          { "name": "prefix", "description": "The prefix slot’s box, before the input." },
          { "name": "input", "description": "The text input. For type=\"date\" it is a combobox that opens the calendar." },
          { "name": "suffix", "description": "The box after the input: clear, the type’s buttons and the suffix slot." },
          { "name": "clear", "description": "The clear button." },
          { "name": "calendar-button", "description": "type=\"date\": the button that opens the calendar." },
          { "name": "hint", "description": "The hint, in the reserved support line." },
          { "name": "error", "description": "The error, in the reserved support line." }
        ],
        "cssProperties": [
          { "name": "--shift-input-border-width", "default": "var(--shift-border-width, var(--_ap-border-width, 1px))", "description": "Shape · control border width" },
          { "name": "--shift-input-button-gap", "default": "2px", "description": "Spacing · between buttons in the suffix" },
          { "name": "--shift-input-button-hover-bg", "default": "var(--_ap-hover-bg, #f1f5f9)", "description": "Colour · icon button on hover" },
          { "name": "--shift-input-button-ink", "default": "var(--shift-ink-muted, var(--_ap-ink-muted, #64748b))", "description": "Colour · icon buttons" },
          { "name": "--shift-input-button-radius", "default": "var(--shift-radius-sm, var(--_ap-radius-sm, 8px))", "description": "Shape · icon button radius" },
          { "name": "--shift-input-button-size", "default": "min(var(--_sz-nav, 32px), calc(var(--_height) - 8px))", "description": "Size · icon button size" },
          {
            "name": "--shift-input-control-height",
            "default": "var(--shift-control-height, calc(var(--_ap-control-height, 44px) * var(--_sz-control, 1)))",
            "description": "Size · control height"
          },
          { "name": "--shift-input-danger", "default": "var(--shift-danger, var(--_ap-danger, #dc2626))", "description": "Colour · error border, message and required mark" },
          { "name": "--shift-input-disabled-ink", "default": "var(--shift-ink-disabled, var(--_ap-ink-disabled, #cbd5e1))", "description": "Colour · text when disabled" },
          {
            "name": "--shift-input-disabled-surface",
            "default": "var(--shift-surface-muted, var(--_ap-surface-muted, #f8fafc))",
            "description": "Colour · control background when disabled"
          },
          { "name": "--shift-input-ease", "default": "var(--shift-ease, cubic-bezier(0.2, 0, 0, 1))", "description": "Motion · easing" },
          { "name": "--shift-input-focus-halo", "default": "var(--_ap-focus-halo, transparent)", "description": "Colour · halo around the focused control" },
          { "name": "--shift-input-focus-halo-width", "default": "var(--_ap-focus-halo-width, 0px)", "description": "Focus · halo width" },
          {
            "name": "--shift-input-focus-outline-width",
            "default": "var(--_ap-control-focus-outline, var(--_focus-width))",
            "description": "Focus · outline ring width (0 for material, whose underline shows focus)"
          },
          { "name": "--shift-input-focus-ring", "default": "var(--shift-focus, var(--_ap-focus, #1e293b))", "description": "Colour · focus ring" },
          { "name": "--shift-input-focus-ring-offset", "default": "var(--_ap-focus-offset, 2px)", "description": "Focus · gap between the control and its ring" },
          { "name": "--shift-input-focus-ring-width", "default": "var(--_ap-focus-width, 2px)", "description": "Focus · ring width" },
          { "name": "--shift-input-font-family", "default": "var(--shift-font-family, var(--_ap-font, 'Nunito', system-ui, sans-serif))", "description": "Type · Latin font" },
          {
            "name": "--shift-input-font-family-arabic",
            "default": "var(--shift-font-family-arabic, 'Noto Kufi Arabic', var(--_font-latin))",
            "description": "Type · Arabic and Kurdish font"
          },
          {
            "name": "--shift-input-font-size",
            "default": "var(--shift-font-size, calc(var(--_ap-font-size, 14px) + var(--_sz-font, 0px)))",
            "description": "Type · input text size"
          },
          { "name": "--shift-input-font-weight", "default": "var(--shift-weight, var(--_ap-weight, 400))", "description": "Type · input text weight" },
          { "name": "--shift-input-icon-size", "default": "var(--_sz-icon, 16px)", "description": "Size · icon size" },
          { "name": "--shift-input-ink", "default": "var(--shift-ink, var(--_ap-ink, #1e293b))", "description": "Colour · input text" },
          {
            "name": "--shift-input-label-font-size",
            "default": "var(--shift-label-size, calc(var(--_ap-label-size, 12px) + var(--_sz-font, 0px)))",
            "description": "Type · label size"
          },
          { "name": "--shift-input-label-font-weight", "default": "var(--_ap-label-weight, 600)", "description": "Type · label weight" },
          { "name": "--shift-input-label-gap", "default": "calc(6px * var(--_sz-space, 1))", "description": "Spacing · between label and control" },
          { "name": "--shift-input-label-ink", "default": "var(--shift-ink, var(--_ap-label-ink, var(--_ap-ink, #1e293b)))", "description": "Colour · label" },
          { "name": "--shift-input-label-tracking", "default": "var(--shift-label-tracking, var(--_ap-label-tracking, 0.04em))", "description": "Type · label letter spacing" },
          { "name": "--shift-input-label-transform", "default": "var(--shift-label-transform, var(--_ap-label-transform, uppercase))", "description": "Type · label case" },
          { "name": "--shift-input-line", "default": "var(--shift-line, var(--_ap-line, #e2e8f0))", "description": "Colour · control border at rest" },
          { "name": "--shift-input-line-height", "default": "1.4", "description": "Type · line height" },
          {
            "name": "--shift-input-line-strong",
            "default": "var(--shift-line-strong, var(--_ap-line-strong, #94a3b8))",
            "description": "Colour · control border on hover, and the underline"
          },
          { "name": "--shift-input-muted", "default": "var(--shift-ink-muted, var(--_ap-ink-muted, #64748b))", "description": "Colour · placeholder, hint and prefix/suffix text" },
          { "name": "--shift-input-padding-inline", "default": "calc(12px * var(--_sz-space, 1))", "description": "Spacing · input padding" },
          { "name": "--shift-input-radius", "default": "var(--shift-radius-md, var(--_ap-radius-md, 8px))", "description": "Shape · control radius" },
          {
            "name": "--shift-input-radius-end",
            "default": "var(--_ap-control-radius-end, var(--_radius))",
            "description": "Shape · bottom corner radius (0 for material and minimal)"
          },
          { "name": "--shift-input-settle", "default": "var(--shift-settle, 320ms)", "description": "Motion · duration of every change" },
          {
            "name": "--shift-input-support-font-size",
            "default": "var(--shift-font-size-sm, calc(var(--_ap-font-size-sm, 12px) + var(--_sz-font, 0px)))",
            "description": "Type · hint and error size"
          },
          { "name": "--shift-input-support-gap", "default": "calc(4px * var(--_sz-space, 1))", "description": "Spacing · between the control and the support line" },
          {
            "name": "--shift-input-surface",
            "default": "var(--shift-surface, var(--_ap-control-fill, var(--_ap-surface, #ffffff)))",
            "description": "Colour · control background"
          },
          {
            "name": "--shift-input-underline-width",
            "default": "var(--_ap-control-underline, 0px)",
            "description": "Shape · underline width (material and minimal); doubled on focus"
          }
        ]
      },
      "runtimeAssets": {
        "locales": null,
        "notes": [
          "One element, one type at a time: text and date now. Each type is a module (types/<type>) that says how a value is shown, how typed text is read back, and what the type adds to the control; a new type adds a module, not a change to the field.",
          "A form field (FormElement): subscribes to form under name, reports value through getValue(), resets to defaultValue, takes required, disabled and error state from the form, and adds a check to the field’s schema that fails while typed text is refused. Standalone it stands on isRequired, isDisabled and errorMessage.",
          "Typed text is read on blur and Enter, never while typing; valueChange fires when the committed value changes.",
          "type=\"date\": value is YYYY-MM-DD or empty. The input shows it in format (default dd/MM/yyyy; tokens d, dd, M, MM, yyyy with any separators) and reads the format with any separators, eight digits in format order, or YYYY-MM-DD; Arabic-Indic digits are read as Latin. An impossible date, one outside min/max and one a rule closes leave the value empty and show a localized message; localization[language].format, .minMessage, .maxMessage ($minDate$, $maxDate$) and .unavailableMessage replace them.",
          "type=\"date\": the calendar button, Alt+ArrowDown and a click in the input (openOnControlClick) open a shift-popover holding shift-calendar, anchored to the input. A click leaves focus in the input so typing continues; the button and Alt+ArrowDown move focus to the selected day, else today, else the first day that can be chosen. Choosing a day writes the value and closes; Escape closes without changing it.",
          "type=\"date\": every shift-calendar prop passes through from one list (types/date/calendar-pass-through.ts): value, month, min, max, enabledDates, disabledDates, disabledWeekdays, isDateDisabled, dayMeta, today, highlightToday, weekStartsOn, numerals, disableViews, showToday, busy, disabled (from isDisabled), label, language, appearance, colorScheme, size.",
          "The support line under the control is reserved in every state and holds the hint or the error, which cross-fade in it, so a message never moves anything below the field. A long message in a narrow field may wrap onto a second line.",
          "Appearance, colour scheme, size and fonts as shift-calendar. The guide gives material and minimal no border: material is the filled text field (muted fill, square bottom corners, an underline that thickens and turns the focus colour on focus), minimal an underline with a muted label. These control tokens are local until appearances.css carries them. Classes on the field travel to its calendar panel."
        ]
      }
    },
    {
      "tag": "shift-day-strip",
      "modulePath": "dist/components/shift-day-strip.js",
      "wireContract": null,
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": [
          "value",
          "min",
          "max",
          "disabledDates",
          "disabledWeekdays",
          "enabledDates",
          "isDateDisabled",
          "dayMeta",
          "today",
          "language",
          "numerals",
          "label",
          "caption",
          "disabled",
          "busy",
          "highlightToday",
          "appearance",
          "colorScheme",
          "size"
        ],
        "methods": ["setFocus"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": ["day strip rendering", "strip scrolling and paging", "keyboard navigation", "single-date selection", "appearance and colour scheme"]
      },
      "api": {
        "props": [
          {
            "name": "appearance",
            "attribute": "appearance",
            "type": "\"material\" | \"minimal\" | \"sharp\" | \"soft\" | \"vanilla\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "vanilla, material, soft, sharp or minimal. Unset renders vanilla. A form passes data.appearance (or the field’s own) through the structure."
          },
          {
            "name": "busy",
            "attribute": "busy",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "The host is loading data: cards dim and cannot be selected, keyboard focus still moves. Sets aria-busy on the listbox."
          },
          {
            "name": "caption",
            "attribute": "caption",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Short text above the strip, at its end, such as “15 days available”. Empty by default, and the row is shut. Content in the caption slot takes its place. The listbox is described by it."
          },
          {
            "name": "colorScheme",
            "attribute": "color-scheme",
            "type": "\"auto\" | \"dark\" | \"light\"",
            "default": "'light'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "light (default), dark, or auto (follows prefers-color-scheme; for hosts that are themselves dark-aware)."
          },
          {
            "name": "dayMeta",
            "attribute": "day-meta",
            "type": "string | { [x: string]: CalendarDayMeta; }",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Per-day extras keyed by YYYY-MM-DD: { badge?: short text, tone?: neutral | info | success | warning | danger, description?: read with the date by screen readers }. The badge sits beside the month label under the number. Object or JSON string."
          },
          {
            "name": "disabled",
            "attribute": "disabled",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "Nothing can be selected or paged with the buttons; no card is in the tab order."
          },
          {
            "name": "disabledDates",
            "attribute": "disabled-dates",
            "type": "string | string[]",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Dates that cannot be chosen: an array or a comma, space or JSON-array string of YYYY-MM-DD. They stay visible, disabled."
          },
          {
            "name": "disabledWeekdays",
            "attribute": "disabled-weekdays",
            "type": "number[] | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Weekdays that cannot be chosen, 0 Sunday … 6 Saturday: [5, 6], \"5,6\", \"5 6\" or \"[5,6]\"."
          },
          {
            "name": "enabledDates",
            "attribute": "enabled-dates",
            "type": "string | string[]",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Allow-list. When set (any array, even an empty one) only these dates can be chosen; without min or max it also sets the first or last day shown. Null, undefined or an empty string turns it off."
          },
          {
            "name": "highlightToday",
            "attribute": "highlight-today",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Marks today visually, in the appearance’s own way. Off by default; aria-current=\"date\" is set on today either way."
          },
          {
            "name": "isDateDisabled",
            "type": "(date: string) => boolean",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "JS property only. (date) => boolean for any other rule; asked only about days no other rule blocked. A throw counts as disabled."
          },
          {
            "name": "label",
            "attribute": "label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Accessible name of the listbox (the field label when used in a form). Default: the localized “Choose a day”."
          },
          {
            "name": "language",
            "attribute": "language",
            "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"",
            "default": "'en'",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "en, ar, ku or ru. Sets names, direction and digits."
          },
          {
            "name": "max",
            "attribute": "max",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Last day shown and latest selectable date (inclusive)."
          },
          {
            "name": "min",
            "attribute": "min",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "First day shown and earliest selectable date (inclusive)."
          },
          {
            "name": "numerals",
            "attribute": "numerals",
            "type": "\"arab\" | \"latn\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "latn or arab. Default by language: Arabic-Indic digits for ar and ku, Latin for en and ru."
          },
          {
            "name": "size",
            "attribute": "size",
            "type": "\"lg\" | \"md\" | \"sm\" | \"xl\" | \"xs\"",
            "default": "'md'",
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "xs, sm, md (default), lg or xl. Scales the cards, type, gaps and buttons. md equals no size."
          },
          {
            "name": "today",
            "attribute": "today",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "YYYY-MM-DD that stands in for today, through ~lib/clock. Empty: the reader’s local calendar date."
          },
          {
            "name": "value",
            "attribute": "value",
            "type": "string",
            "default": "''",
            "mutable": true,
            "required": false,
            "reflect": true,
            "description": "Selected date as YYYY-MM-DD, or empty. Updated when the user selects a day; a host may set it, and the strip scrolls to it."
          }
        ],
        "methods": [
          {
            "name": "setFocus",
            "parameters": "() => Promise<void>",
            "returns": "Promise<void>",
            "description": "Moves focus to the card in the tab order and scrolls the strip to it."
          }
        ],
        "events": [
          {
            "name": "dateChange",
            "type": "DayStripDateChangeDetail",
            "description": "Detail { value: YYYY-MM-DD }. Fires on every user selection, including re-selecting the current value; never for a disabled day or when a host sets value."
          }
        ],
        "dependencies": [],
        "parts": [
          { "name": "root", "description": "The whole strip: the caption row and the row of buttons and cards." },
          { "name": "caption", "description": "The caption above the strip (caption prop or caption slot)." },
          { "name": "prev", "description": "Previous-page button, at the inline start. Disabled at the start." },
          { "name": "next", "description": "Next-page button, at the inline end. Disabled at the end." },
          { "name": "viewport", "description": "The scrolling, snapping box that clips the cards and carries the edge fades." },
          { "name": "list", "description": "The role=listbox row of cards." },
          { "name": "day", "description": "Every day card. State parts are added beside it: day-selected, day-today, day-disabled, day-closed." },
          { "name": "day-selected", "description": "The selected day." },
          { "name": "day-today", "description": "Today, with highlightToday only." },
          { "name": "day-disabled", "description": "Any day that cannot be selected." },
          { "name": "day-closed", "description": "A day ruled out by disabledDates, disabledWeekdays or isDateDisabled (struck through in vanilla and sharp)." },
          { "name": "weekday", "description": "The weekday abbreviation at the top of a card." },
          { "name": "day-number", "description": "The day number." },
          { "name": "month", "description": "The month label, on the first card and on each first of the month." },
          { "name": "badge", "description": "The dayMeta badge, beside the month label." }
        ],
        "cssProperties": [
          { "name": "--shift-day-strip-accent", "default": "var(--shift-accent, var(--_ap-accent, #1e293b))", "description": "Colour · selected card fill" },
          { "name": "--shift-day-strip-badge-font-size", "default": "calc(10px + var(--_sz-font, 0px) / 2)", "description": "Type · badge size" },
          { "name": "--shift-day-strip-badge-font-weight", "default": "700", "description": "Type · badge weight" },
          { "name": "--shift-day-strip-badge-gap", "default": "3px", "description": "Spacing · between the month label and the badge" },
          { "name": "--shift-day-strip-badge-line-height", "default": "12px", "description": "Type · badge line height" },
          { "name": "--shift-day-strip-badge-radius", "default": "999px", "description": "Shape · badge radius" },
          { "name": "--shift-day-strip-blocked-border-style", "default": "dashed", "description": "Shape · unavailable card border style (dashed by default)" },
          {
            "name": "--shift-day-strip-blocked-decoration",
            "default": "var(--_ap-blocked-decoration, line-through)",
            "description": "Type · closed day number decoration (e.g. line-through)"
          },
          { "name": "--shift-day-strip-blocked-opacity", "default": "var(--_ap-blocked-opacity, 1)", "description": "Colour · closed day opacity" },
          { "name": "--shift-day-strip-border-width", "default": "var(--shift-border-width, var(--_ap-border-width, 1px))", "description": "Shape · card and button border width" },
          {
            "name": "--shift-day-strip-caption-font-size",
            "default": "var(--shift-font-size-sm, calc(var(--_ap-font-size-sm, 12px) + var(--_sz-font, 0px)))",
            "description": "Type · caption size"
          },
          { "name": "--shift-day-strip-caption-gap", "default": "calc(8px * var(--_sz-space, 1))", "description": "Spacing · between the caption and the cards" },
          { "name": "--shift-day-strip-caption-ink", "default": "var(--shift-ink-muted, var(--_ap-ink-muted, #64748b))", "description": "Colour · caption text" },
          {
            "name": "--shift-day-strip-cell-size",
            "default": "var(--shift-cell-size, calc(var(--_ap-cell-size, 40px) * var(--_sz-control, 1)))",
            "description": "Size · density unit; a card is 1.45 of it wide"
          },
          {
            "name": "--shift-day-strip-day-font-size",
            "default": "calc(var(--shift-font-size, calc(var(--_ap-font-size, 14px) + var(--_sz-font, 0px))) * 1.5)",
            "description": "Type · day number size"
          },
          { "name": "--shift-day-strip-day-font-weight", "default": "var(--shift-weight-strong, var(--_ap-weight-strong, 600))", "description": "Type · day number weight" },
          { "name": "--shift-day-strip-day-hover-bg", "default": "var(--_ap-hover-bg, #f1f5f9)", "description": "Colour · card background on hover" },
          { "name": "--shift-day-strip-day-hover-ink", "default": "var(--_ap-hover-ink, #1e293b)", "description": "Colour · card text on hover" },
          { "name": "--shift-day-strip-day-hover-line", "default": "var(--shift-line-strong, var(--_ap-hover-line, #94a3b8))", "description": "Colour · card outline on hover" },
          { "name": "--shift-day-strip-day-line", "default": "var(--shift-line, var(--_ap-line, #e2e8f0))", "description": "Colour · card outline at rest" },
          { "name": "--shift-day-strip-day-line-height", "default": "1.25", "description": "Type · day number line height" },
          {
            "name": "--shift-day-strip-day-padding-bottom",
            "default": "calc((7px + var(--_touch, 0) * 1px) * var(--_sz-space, 1))",
            "description": "Spacing · card padding below"
          },
          { "name": "--shift-day-strip-day-padding-inline", "default": "calc(4px * var(--_sz-space, 1))", "description": "Spacing · card padding at the sides" },
          { "name": "--shift-day-strip-day-padding-top", "default": "calc((6px + var(--_touch, 0) * 2px) * var(--_sz-space, 1))", "description": "Spacing · card padding above" },
          { "name": "--shift-day-strip-day-radius", "default": "var(--shift-radius-sm, var(--_ap-radius-sm, 8px))", "description": "Shape · card radius" },
          { "name": "--shift-day-strip-day-row-gap", "default": "1px", "description": "Spacing · between the lines of a card" },
          {
            "name": "--shift-day-strip-day-shadow",
            "default": "var(--shift-shadow-control, var(--_ap-shadow-control, none))",
            "description": "Effect · card and button elevation"
          },
          { "name": "--shift-day-strip-day-surface", "default": "var(--shift-surface, var(--_ap-surface, #ffffff))", "description": "Colour · card background" },
          { "name": "--shift-day-strip-day-width", "default": "calc(var(--_cell) * 1.45 + var(--_touch, 0) * 4px)", "description": "Size · card width" },
          { "name": "--shift-day-strip-disabled-font-weight", "default": "var(--shift-weight, var(--_ap-weight, 400))", "description": "Type · unavailable day number weight" },
          { "name": "--shift-day-strip-disabled-ink", "default": "var(--shift-ink-disabled, var(--_ap-ink-disabled, #cbd5e1))", "description": "Colour · unavailable days" },
          {
            "name": "--shift-day-strip-disabled-surface",
            "default": "var(--shift-surface-muted, var(--_ap-surface-muted, #f8fafc))",
            "description": "Colour · unavailable card background"
          },
          { "name": "--shift-day-strip-ease", "default": "var(--shift-ease, ease)", "description": "Motion · easing of every movement" },
          {
            "name": "--shift-day-strip-fade",
            "default": "calc(12px * var(--_sz-space, 1))",
            "description": "Size · edge fade width; a scrolled card comes to rest just inside it"
          },
          { "name": "--shift-day-strip-focus-halo", "default": "var(--_ap-focus-halo, transparent)", "description": "Colour · halo around a focused button" },
          { "name": "--shift-day-strip-focus-halo-width", "default": "var(--_ap-focus-halo-width, 0px)", "description": "Focus · halo width" },
          { "name": "--shift-day-strip-focus-inner", "default": "var(--_ap-focus-inner, #ffffff)", "description": "Colour · band inside a card’s focus ring" },
          { "name": "--shift-day-strip-focus-ring", "default": "var(--shift-focus, var(--_ap-focus, #1e293b))", "description": "Colour · focus ring" },
          { "name": "--shift-day-strip-focus-ring-offset", "default": "var(--_ap-focus-offset, 2px)", "description": "Focus · gap between a button and its ring" },
          { "name": "--shift-day-strip-focus-ring-width", "default": "var(--_ap-focus-width, 2px)", "description": "Focus · ring width" },
          { "name": "--shift-day-strip-font-family", "default": "var(--shift-font-family, var(--_ap-font, 'Nunito', system-ui, sans-serif))", "description": "Type · Latin font" },
          {
            "name": "--shift-day-strip-font-family-arabic",
            "default": "var(--shift-font-family-arabic, 'Noto Kufi Arabic', var(--_font-latin))",
            "description": "Type · Arabic and Kurdish font"
          },
          {
            "name": "--shift-day-strip-font-size",
            "default": "var(--shift-font-size, calc(var(--_ap-font-size, 14px) + var(--_sz-font, 0px)))",
            "description": "Type · base size"
          },
          { "name": "--shift-day-strip-gap", "default": "calc(var(--shift-gap, var(--_ap-gap, 4px)) * 2 * var(--_sz-space, 1))", "description": "Spacing · between cards" },
          { "name": "--shift-day-strip-ink", "default": "var(--shift-ink, var(--_ap-ink, #1e293b))", "description": "Colour · main text" },
          {
            "name": "--shift-day-strip-label-font-size",
            "default": "calc(var(--shift-font-size-sm, calc(var(--_ap-font-size-sm, 12px) + var(--_sz-font, 0px))) - 2px)",
            "description": "Type · weekday and month label size"
          },
          { "name": "--shift-day-strip-label-line-height", "default": "1.9", "description": "Type · weekday and month label line height" },
          { "name": "--shift-day-strip-muted", "default": "var(--shift-ink-muted, var(--_ap-ink-muted, #64748b))", "description": "Colour · weekday and month labels" },
          { "name": "--shift-day-strip-nav-border", "default": "var(--shift-line, var(--_ap-line, #e2e8f0))", "description": "Colour · previous/next button outline" },
          { "name": "--shift-day-strip-nav-gap", "default": "calc(4px * var(--_sz-space, 1))", "description": "Spacing · between the buttons and the cards" },
          { "name": "--shift-day-strip-nav-hover-bg", "default": "var(--_ap-hover-bg, #f1f5f9)", "description": "Colour · previous/next button on hover" },
          { "name": "--shift-day-strip-nav-icon-size", "default": "var(--_sz-icon, 16px)", "description": "Size · arrow icon size" },
          { "name": "--shift-day-strip-nav-ink", "default": "var(--shift-ink, var(--_ap-ink, #1e293b))", "description": "Colour · previous/next button icons" },
          { "name": "--shift-day-strip-nav-radius", "default": "999px", "description": "Shape · previous/next button radius (round)" },
          { "name": "--shift-day-strip-nav-size", "default": "var(--_sz-nav, 32px)", "description": "Size · previous/next button size" },
          { "name": "--shift-day-strip-nav-surface", "default": "var(--shift-surface, var(--_ap-surface, #ffffff))", "description": "Colour · previous/next button background" },
          { "name": "--shift-day-strip-on-accent", "default": "var(--shift-on-accent, var(--_ap-on-accent, #ffffff))", "description": "Colour · text on the selected card" },
          { "name": "--shift-day-strip-settle", "default": "var(--shift-settle, 320ms)", "description": "Motion · duration of every movement" },
          {
            "name": "--shift-day-strip-shadow-room",
            "default": "var(--_soft-shadow-room, var(--_lift-block))",
            "description": "Spacing · room below the cards for their shadow (20px in soft, else the hover lift)"
          },
          { "name": "--shift-day-strip-today-dot", "default": "var(--_ap-today-dot, transparent)", "description": "Colour · today’s dot (with highlightToday)" },
          { "name": "--shift-day-strip-today-dot-size", "default": "4px", "description": "Today · dot size" },
          { "name": "--shift-day-strip-today-mark-decoration", "default": "var(--_ap-today-decoration, none)", "description": "Today · number decoration (e.g. underline)" },
          { "name": "--shift-day-strip-today-mark-stroke", "default": "var(--_ap-today-stroke, 0px)", "description": "Today · text stroke that bolds the number" },
          { "name": "--shift-day-strip-today-ring", "default": "var(--_ap-today-ring, #64748b)", "description": "Colour · today’s ring (with highlightToday)" },
          { "name": "--shift-day-strip-today-ring-width", "default": "var(--_ap-today-ring-width, 1px)", "description": "Today · ring width" },
          { "name": "--shift-day-strip-tone-danger-bg", "default": "var(--_ap-tone-danger-bg, #fff1f0)", "description": "Badge · danger background" },
          { "name": "--shift-day-strip-tone-danger-ink", "default": "var(--_ap-tone-danger-ink, #9b2c2c)", "description": "Badge · danger text" },
          { "name": "--shift-day-strip-tone-info-bg", "default": "var(--_ap-tone-info-bg, #e8f1f8)", "description": "Badge · info background" },
          { "name": "--shift-day-strip-tone-info-ink", "default": "var(--_ap-tone-info-ink, #275e8f)", "description": "Badge · info text" },
          { "name": "--shift-day-strip-tone-neutral-bg", "default": "var(--_ap-tone-neutral-bg, #e8ecef)", "description": "Badge · neutral background" },
          { "name": "--shift-day-strip-tone-neutral-ink", "default": "var(--_ap-tone-neutral-ink, #46535e)", "description": "Badge · neutral text" },
          { "name": "--shift-day-strip-tone-success-bg", "default": "var(--_ap-tone-success-bg, #e8f4ed)", "description": "Badge · success background" },
          { "name": "--shift-day-strip-tone-success-ink", "default": "var(--_ap-tone-success-ink, #216b44)", "description": "Badge · success text" },
          { "name": "--shift-day-strip-tone-warning-bg", "default": "var(--_ap-tone-warning-bg, #fff7e6)", "description": "Badge · warning background" },
          { "name": "--shift-day-strip-tone-warning-ink", "default": "var(--_ap-tone-warning-ink, #8a5a12)", "description": "Badge · warning text" },
          { "name": "--shift-day-strip-weekday-tracking", "default": "0.025em", "description": "Type · weekday letter spacing" },
          { "name": "--shift-day-strip-weekday-transform", "default": "uppercase", "description": "Type · weekday case" }
        ]
      },
      "runtimeAssets": {
        "locales": null,
        "notes": [
          "The day-strip counterpart of shift-calendar: the same inputs, the same dateChange, a horizontal row of day cards instead of a month grid. It makes no requests and knows nothing about branches or times.",
          "Which days appear: min to max. When enabledDates is set and an end of the range is missing, that end is the first or last enabled date; with neither, 30 days from today (or the 30 days ending at max, when max is before today). A min later than max shows no days.",
          "At most 366 days are rendered, counted from the first day of the range. Later days are not shown and cannot be selected; a value among them selects no card.",
          "Rule precedence is shift-calendar’s, through the same library: range (min/max) → disabledDates → disabledWeekdays → not in enabledDates → isDateDisabled. Blocked days stay visible as disabled cards (data-reason names the rule); rules only ever block.",
          "Semantics: a horizontal listbox of options (WAI-ARIA APG listbox), not a radiogroup, because the arrow keys move focus without selecting and Enter or Space selects; a radiogroup checks the radio the arrows land on. One card is in the tab order (roving tabindex): the selected day, else today, else the first open day. Disabled days are focusable with aria-disabled so they can be discovered.",
          "Moving focus, setting value and the previous/next buttons scroll the strip only, never the page or an overflow: hidden ancestor. On first render the selected card is placed without animation; later changes scroll smoothly (instantly under prefers-reduced-motion). Scrolling snaps per card; touch swipe and trackpad scroll natively.",
          "The previous and next buttons scroll by one visible page and are disabled at the ends. The edge fades grow with the distance scrolled, so they appear only where content continues.",
          "The strip’s height never changes with selection, month labels, badges, highlightToday or the colour scheme; only another size, another density (appearance), the caption row, or the phone layout below a 600px viewport (roomier cards, as in the booking prototype) changes it.",
          "Appearance and colour scheme follow the shared appearance rules: every value resolves as --shift-day-strip-x, then --shift-x, then the appearance, then the vanilla baseline, so host variables win in light and dark. The component never sets --shift-* itself.",
          "Fonts: Nunito (vanilla, material, soft) or Manrope (sharp, minimal), with Noto Kufi Arabic first for ar and ku — all loaded by the package’s global script. Override with --shift-font-family and --shift-font-family-arabic."
        ]
      }
    },
    {
      "tag": "vin-extractor",
      "modulePath": "dist/components/vin-extractor.js",
      "wireContract": null,
      "supportedLocales": ["en", "ar", "ku", "ru"],
      "host": {
        "properties": [
          "title",
          "useOcr",
          "ocrEndpoint",
          "readSticker",
          "manualCapture",
          "manualCaptureLabel",
          "manualCaptureHint",
          "captureInterval",
          "skipValidation",
          "uploaderButtonId",
          "captureEnvironment",
          "language",
          "colorScheme",
          "dialogLabel",
          "switchCameraLabel",
          "closeLabel",
          "capturingLabel",
          "previewLabel",
          "uploadLabel",
          "permissionsFallback",
          "onExtract",
          "onError",
          "onProcessing",
          "onOpenChange"
        ],
        "methods": ["open", "close"],
        "sequence": ["load module", "wait for custom element definition", "set properties", "call a documented method"],
        "owns": [
          "camera access and lens choice",
          "frame capture, OCR request and sticker decoding",
          "VIN validation",
          "the full-screen sheet on phones and the popup on wider screens",
          "body overflow hidden while open, auto after close"
        ]
      },
      "api": {
        "props": [
          {
            "name": "captureEnvironment",
            "attribute": "capture-environment",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "With uploaderButtonId: asks the device to open the rear camera for a new photo rather than offering existing files."
          },
          {
            "name": "captureInterval",
            "attribute": "capture-interval",
            "type": "number",
            "default": "2000",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Milliseconds between automatic captures when manualCapture is off. 2000 by default."
          },
          {
            "name": "capturingLabel",
            "attribute": "capturing-label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Accessible name of the capture button while a capture is in flight. Otherwise the language’s string, “Capturing...” in English."
          },
          {
            "name": "closeLabel",
            "attribute": "close-label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Accessible name of the close button. Otherwise the language’s string, “Close scanner” in English."
          },
          {
            "name": "colorScheme",
            "attribute": "color-scheme",
            "type": "\"auto\" | \"dark\" | \"light\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": true,
            "description": "Unset (default) renders light and adds no attribute. light, dark, or auto (follows prefers-color-scheme)."
          },
          {
            "name": "dialogLabel",
            "attribute": "dialog-label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Accessible name of the dialog when there is no title. Otherwise the language’s string, “VIN Scanner” in English."
          },
          {
            "name": "language",
            "attribute": "language",
            "type": "\"ar\" | \"en\" | \"ku\" | \"ru\"",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "en, ar, ku or ru. Unset (default): English names and no direction of its own, so it follows the page. Set: the accessible names the component writes itself are in that language, and ar and ku lay it out right to left in the Arabic font."
          },
          {
            "name": "manualCapture",
            "attribute": "manual-capture",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Shows a capture button and reads a frame only when it is pressed, instead of capturing every captureInterval."
          },
          {
            "name": "manualCaptureHint",
            "attribute": "manual-capture-hint",
            "type": "string",
            "default": "''",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Short line shown above the capture button (manualCapture only), hidden while a capture is in flight."
          },
          {
            "name": "manualCaptureLabel",
            "attribute": "manual-capture-label",
            "type": "string",
            "default": "''",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Text on the capture button and its accessible name. Without it the button shows a camera icon and is named “Capture VIN” in language."
          },
          {
            "name": "ocrEndpoint",
            "attribute": "ocr-endpoint",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "URL that receives a POST with { image } (base64 PNG) and answers with the VIN as plain text."
          },
          {
            "name": "onError",
            "attribute": "on-error",
            "type": "((newError: Error) => void) | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Called with the Error when the camera cannot be opened, a request fails or a frame cannot be read. A function, or a Blazor method name."
          },
          {
            "name": "onExtract",
            "attribute": "on-extract",
            "type": "((vin: string) => void) | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Called with the VIN when one is read. A function, or a Blazor method name after setBlazorRef."
          },
          {
            "name": "onOpenChange",
            "attribute": "on-open-change",
            "type": "((newError: boolean) => void) | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Called with true on open and false on close. A function, or a Blazor method name."
          },
          {
            "name": "onProcessing",
            "attribute": "on-processing",
            "type": "((vin: string) => void) | string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Called with true when a frame starts being read and false when it is done. A function, or a Blazor method name."
          },
          {
            "name": "permissionsFallback",
            "attribute": "permissions-fallback",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Off (default): the camera permission is read from the Permissions API first, and a browser without it (or one that does not know camera) reports an error. On: where that query is missing or fails, the scanner asks for the camera directly and the browser prompts; everything after is unchanged."
          },
          {
            "name": "previewLabel",
            "attribute": "preview-label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Accessible name of the camera picture. Otherwise the language’s string, “Camera preview” in English."
          },
          {
            "name": "readSticker",
            "attribute": "read-sticker",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Decodes a barcode or QR code in each captured frame (the decoder library is loaded from a CDN on first use)."
          },
          {
            "name": "skipValidation",
            "attribute": "skip-validation",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Reports whatever was read, without checking that it is a valid VIN."
          },
          {
            "name": "switchCameraLabel",
            "attribute": "switch-camera-label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Accessible name of the switch-camera button. Otherwise the language’s string, “Switch camera” in English."
          },
          {
            "name": "title",
            "attribute": "title",
            "type": "string",
            "default": "''",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Text in the header, and the dialog’s accessible name. Without it the header is empty and the dialog is named “VIN Scanner” in language."
          },
          {
            "name": "uploadLabel",
            "attribute": "upload-label",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Accessible name of the hidden file input. Otherwise the language’s string, “Upload VIN image” in English."
          },
          {
            "name": "uploaderButtonId",
            "attribute": "uploader-button-id",
            "type": "string",
            "default": null,
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Id of a button on the page that opens a file picker instead of the camera; the chosen image is read the same way. The camera overlay is not rendered in this mode."
          },
          {
            "name": "useOcr",
            "attribute": "use-ocr",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Sends each captured frame to ocrEndpoint and reports the VIN it answers."
          },
          {
            "name": "verbose",
            "attribute": "verbose",
            "type": "boolean",
            "default": "false",
            "mutable": false,
            "required": false,
            "reflect": false,
            "description": "Logs camera, OCR and sticker diagnostics to the console."
          }
        ],
        "methods": [
          {
            "name": "close",
            "parameters": "() => Promise<void>",
            "returns": "Promise<void>",
            "description": "Closes the scanner, stops the camera and sets the body overflow to auto."
          },
          {
            "name": "open",
            "parameters": "() => Promise<void>",
            "returns": "Promise<void>",
            "description": "Opens the scanner: asks for the camera, starts it and sets the body overflow to hidden."
          },
          {
            "name": "setBlazorRef",
            "parameters": "(newBlazorRef: DotNetObjectReference) => Promise<void>",
            "returns": "Promise<void>",
            "description": "Blazor only: the .NET object reference whose methods the callback properties name."
          }
        ],
        "events": [],
        "dependencies": [],
        "parts": [
          { "name": "backdrop", "description": "The full-viewport layer behind the panel (role=dialog); dimmed and blurred from 768px." },
          { "name": "panel", "description": "The scanner itself: the full-screen sheet on phones, the 600px popup from 768px." },
          { "name": "header", "description": "The bar holding the switch-camera button, the title and the close button." },
          { "name": "title", "description": "The header text. Also exposed as form-input-label." },
          { "name": "form-input-label", "description": "Older name of title, kept for existing stylesheets." },
          { "name": "switch-camera", "description": "Button that switches between the front and the rear camera; only when the device has more than one." },
          { "name": "close", "description": "The close button." },
          { "name": "switch-camera-icon", "description": "The built-in icon in the switch-camera button (the fallback of the switch-camera-icon slot)." },
          { "name": "close-icon", "description": "The built-in icon in the close button (the fallback of the close-icon slot)." },
          { "name": "preview", "description": "The live camera picture (a video element)." },
          { "name": "hint", "description": "The manualCaptureHint line above the capture button." },
          { "name": "capture", "description": "The capture button (manualCapture only). Also exposed as vin-extractor-capture-button." },
          { "name": "vin-extractor-capture-button", "description": "Older name of capture, kept for existing stylesheets." },
          { "name": "capture-icon", "description": "The built-in camera icon in the capture button when there is no manualCaptureLabel (the fallback of the capture-icon slot)." },
          { "name": "capture-label", "description": "The manualCaptureLabel text in the capture button." },
          { "name": "capture-spinner", "description": "The spinner that replaces the icon or label while a capture is being read." }
        ],
        "cssProperties": [
          { "name": "--shift-vin-extractor-accent", "default": "#ffffff", "description": "Colour · capture button fill; 75% while a capture is in flight" },
          {
            "name": "--shift-vin-extractor-backdrop",
            "default": "var(--_sc-backdrop, rgb(0 0 0 / 0.4))",
            "description": "Colour · the dimmed page behind the popup (from 768px); darker in the dark scheme"
          },
          { "name": "--shift-vin-extractor-backdrop-blur", "default": "1.5px", "description": "Effect · how much the page behind the popup blurs" },
          { "name": "--shift-vin-extractor-bar-blur", "default": "6px", "description": "Effect · blur behind that bar" },
          { "name": "--shift-vin-extractor-bar-ink", "default": "#f1f5f9", "description": "Colour · title on that bar" },
          { "name": "--shift-vin-extractor-bar-surface", "default": "rgb(0 0 0 / 0.3)", "description": "Colour · the translucent header bar over the picture on phones" },
          { "name": "--shift-vin-extractor-capture-border", "default": "var(--_on-accent)", "description": "Colour · capture button border (the on-accent colour by default)" },
          { "name": "--shift-vin-extractor-capture-radius", "default": "9999px", "description": "Shape · capture button radius (a pill by default)" },
          {
            "name": "--shift-vin-extractor-capture-shadow",
            "default": "0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)",
            "description": "Colour · capture button shadow"
          },
          {
            "name": "--shift-vin-extractor-control-hover-bg",
            "default": "var(--_sc-sheet-hover-bg, #cbd5e1)",
            "description": "Colour · header button background on hover (#cbd5e1 on phones, #f1f5f9 in the popup)"
          },
          { "name": "--shift-vin-extractor-control-hover-ink", "default": "var(--_sc-hover-ink, #334155)", "description": "Colour · header button icon and border on hover" },
          { "name": "--shift-vin-extractor-control-radius", "default": "0.5rem", "description": "Shape · header button radius" },
          {
            "name": "--shift-vin-extractor-control-surface",
            "default": "var(--_sc-control-surface, #f1f5f9)",
            "description": "Colour · header button background (#f1f5f9 on phones, the surface in the popup)"
          },
          { "name": "--shift-vin-extractor-font-family", "default": "'Noto Kufi Arabic', 'Nunito', Roboto, Arial, sans-serif", "description": "Type · Latin and Cyrillic font" },
          { "name": "--shift-vin-extractor-font-family-arabic", "default": "var(--_font)", "description": "Type · Arabic and Kurdish font" },
          {
            "name": "--shift-vin-extractor-header-shadow",
            "default": "0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -2px rgba(0, 0, 0, 0.1)",
            "description": "Colour · header bar shadow"
          },
          { "name": "--shift-vin-extractor-hint-ink", "default": "#ffffff", "description": "Colour · hint text" },
          { "name": "--shift-vin-extractor-hint-radius", "default": "9999px", "description": "Shape · hint radius (a pill by default)" },
          { "name": "--shift-vin-extractor-hint-surface", "default": "rgb(0 0 0 / 0.55)", "description": "Colour · hint background" },
          { "name": "--shift-vin-extractor-ink", "default": "var(--_sc-ink, #000000)", "description": "Colour · popup title" },
          { "name": "--shift-vin-extractor-line", "default": "var(--_sc-line, #475569)", "description": "Colour · border of the header buttons on phones" },
          { "name": "--shift-vin-extractor-muted", "default": "var(--_sc-muted, #475569)", "description": "Colour · switch-camera and close icons" },
          { "name": "--shift-vin-extractor-on-accent", "default": "#64748b", "description": "Colour · capture button icon, label and spinner" },
          { "name": "--shift-vin-extractor-preview-surface", "default": "#000000", "description": "Colour · behind the camera picture before it starts" },
          { "name": "--shift-vin-extractor-radius", "default": "0.5rem", "description": "Shape · popup corner radius" },
          { "name": "--shift-vin-extractor-shadow", "default": "0 4px 6px -1px rgb(0 0 0 / 0.1)", "description": "Colour · popup shadow" },
          { "name": "--shift-vin-extractor-surface", "default": "var(--_sc-surface, #ffffff)", "description": "Colour · popup header and its buttons" }
        ]
      },
      "runtimeAssets": {
        "locales": null,
        "notes": [
          "Results are reported through callback properties, not DOM events: set onExtract, onError, onProcessing and onOpenChange to functions on the element (or, from Blazor, to method names after setBlazorRef). An attribute cannot carry a function.",
          "Open it with open() and close it with close(); the backdrop and the close button also close it. While it is open the page does not scroll: open sets the body’s inline overflow to hidden and close sets it to auto. A page that needs another value restores it itself in onOpenChange.",
          "The strings it renders itself (the accessible names of the dialog, its buttons, the preview and the file input) come from language; title, manualCaptureLabel and manualCaptureHint are the host’s own text and are shown as given.",
          "The header bar, the hint and the capture button sit on the camera picture on phones, so colorScheme leaves them as they are; it changes the popup’s header, its buttons and the backdrop.",
          "Icons are slots whose fallback is the built-in icon: give the element a child with slot=\"switch-camera-icon\", slot=\"close-icon\" or slot=\"capture-icon\" (an svg or img) and style it with the page’s own CSS; it sits inside the button where the icon was. The capture icon slot shows only while the button has no manualCaptureLabel and no capture is in flight. Children without a slot attribute still go to the default slot, which is where the uploaderButtonId button lives.",
          "Each accessible name the component writes is the host’s prop when it is not empty, else the language’s string when language is set, else the English default.",
          "Under 768px of viewport width it is a full-screen sheet that slides in; from 768px it is a 600px popup over a dimmed page.",
          "It reads only its own --shift-vin-extractor-* variables, never the shared --shift-* ones, so a page themed for the other components leaves it as it is. Without any of its variables, language or colorScheme it renders exactly as before they existed."
        ]
      }
    }
  ]
}
