@ticketlayer/elements 0.2.0

package/dist/types/components.d.ts

@@ -0,0 +1,1629 @@
+/* eslint-disable */
+/* tslint:disable */
+/**
+ * This is an autogenerated file created by the Stencil compiler.
+ * It contains typing information for all components that exist in this project.
+ */
+import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
+import { ButtonSize, ButtonState, ButtonVariant } from "./components/tl-buy-tickets-button/tl-buy-tickets-button";
+import { OrderResult } from "./utils/sdk-connector";
+import { TlCartData } from "./components/tl-cart/tl-cart";
+import { TlEventCardEvent } from "./components/tl-event-card/tl-event-card";
+import { TlAuthChanged } from "./components/tl-login/tl-login";
+import { TlOccurrence, TlOccurrenceSelectorTheme } from "./components/tl-occurrence-selector/tl-occurrence-selector";
+import { TlOrderData } from "./utils/order-summary";
+import { TlPromoApplied } from "./components/tl-promo-code/tl-promo-code";
+import { TlTicketData } from "./components/tl-ticket/tl-ticket";
+import { AddToCartItem } from "./components/tl-ticket-selector/tl-ticket-selector";
+export { ButtonSize, ButtonState, ButtonVariant } from "./components/tl-buy-tickets-button/tl-buy-tickets-button";
+export { OrderResult } from "./utils/sdk-connector";
+export { TlCartData } from "./components/tl-cart/tl-cart";
+export { TlEventCardEvent } from "./components/tl-event-card/tl-event-card";
+export { TlAuthChanged } from "./components/tl-login/tl-login";
+export { TlOccurrence, TlOccurrenceSelectorTheme } from "./components/tl-occurrence-selector/tl-occurrence-selector";
+export { TlOrderData } from "./utils/order-summary";
+export { TlPromoApplied } from "./components/tl-promo-code/tl-promo-code";
+export { TlTicketData } from "./components/tl-ticket/tl-ticket";
+export { AddToCartItem } from "./components/tl-ticket-selector/tl-ticket-selector";
+export namespace Components {
+    /**
+     * @component tl-buy-modal
+     * The in-page buy-tickets funnel: occurrence → ticket selection → added.
+     * A NATIVE Elements overlay (no iframe) - it simply composes the existing
+     * `tl-occurrence-selector` and `tl-ticket-selector`, which already bind to the
+     * SDK and add to the cart. Because it's pure browse/cart (zero PCI surface), it
+     * renders in-page identically on HBO and on any third-party embed bound to
+     * `window.Ticketlayer`. Only the *checkout* step crosses into an iframe.
+     * It is not placed in markup by hosts: the SDK's buy-modal manager mounts it on
+     * demand when something emits `ui:event-modal-requested` (e.g. a
+     * `tl-buy-tickets-button` or a calendar date click), and removes it on close.
+     * @event tlClose    - user dismissed the modal (keep browsing)
+     * @event tlCheckout - user chose to proceed to checkout (manager hands off to
+     *              the checkout intent: iframe on embeds, /checkout on HBO)
+     * @event tlError    - the event couldn't be loaded
+     */
+    interface TlBuyModal {
+        /**
+          * Event to sell tickets for.
+         */
+        "eventId": string;
+        /**
+          * Optionally open straight to ticket selection for this occurrence.
+         */
+        "occurrenceId"?: string;
+    }
+    interface TlBuyTicketsButton {
+        /**
+          * Currency code for price formatting
+          * @default 'GBP'
+         */
+        "currency": string;
+        /**
+          * Disabled state
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Event ID to purchase tickets for
+         */
+        "eventId": string;
+        /**
+          * Full width button
+          * @default false
+         */
+        "fullWidth": boolean;
+        /**
+          * Button label override (default depends on state)
+         */
+        "label"?: string;
+        /**
+          * Optional pre-selected occurrence ID
+         */
+        "occurrenceId"?: string;
+        /**
+          * Price to display (in minor units e.g. pence)
+         */
+        "price"?: number;
+        /**
+          * Show price prefix text
+          * @default 'From'
+         */
+        "pricePrefix": string;
+        /**
+          * Button size
+          * @default 'md'
+         */
+        "size": ButtonSize;
+        /**
+          * Button state - determines colour, label, and icon
+          * @default 'available'
+         */
+        "state": ButtonState;
+        /**
+          * Button variant
+          * @default 'primary'
+         */
+        "variant": ButtonVariant;
+    }
+    /**
+     * @component tl-buy-tickets-wrapper
+     * Wraps any content and opens the Ticketlayer modal when clicked.
+     * Uses the SDK's modal manager which handles the iframe overlay.
+     * @example <tl-buy-tickets-wrapper event-id="evt_001">
+     *   <button>Buy Tickets</button>
+     * </tl-buy-tickets-wrapper>
+     * @example <tl-buy-tickets-wrapper event-id="evt_001" occurrence-id="occ_001">
+     *   <button>Get Tickets for Saturday</button>
+     * </tl-buy-tickets-wrapper>
+     */
+    interface TlBuyTicketsWrapper {
+        /**
+          * Whether the wrapper is disabled
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * The event ID to purchase tickets for
+         */
+        "eventId": string;
+        /**
+          * Optional specific occurrence ID (skips occurrence selector)
+         */
+        "occurrenceId"?: string;
+    }
+    interface TlCart {
+        /**
+          * Checkout button label
+          * @default 'Checkout'
+         */
+        "checkoutLabel": string;
+        /**
+          * Compact mode - hides some details
+          * @default false
+         */
+        "compact": boolean;
+        /**
+          * Show checkout button
+          * @default true
+         */
+        "showCheckoutButton": boolean;
+        /**
+          * Show remove item buttons
+          * @default true
+         */
+        "showRemoveButtons": boolean;
+    }
+    interface TlCartBadge {
+        /**
+          * Badge only mode - only shows the count bubble, no icon or button
+          * @default false
+         */
+        "badgeOnly": boolean;
+        /**
+          * Custom icon (emoji or text). If not provided, uses cart SVG
+         */
+        "icon"?: string;
+        /**
+          * Show the badge even when count is 0
+          * @default false
+         */
+        "showEmpty": boolean;
+        /**
+          * Size variant
+          * @default 'md'
+         */
+        "size": 'sm' | 'md' | 'lg';
+    }
+    /**
+     * @component tl-cart-drawer
+     * A slide-in cart panel (off-canvas) showing the current cart. It opens when
+     * anything raises the `ui:cart-requested` bus intent - e.g. wire a
+     * `tl-cart-badge`'s click to emit it - and closes on the backdrop, the close
+     * button, Escape, or `ui:modal-close-requested`. The panel embeds `<tl-cart>`,
+     * so the actual cart rendering / remove / checkout is shared with the inline
+     * cart; the drawer only adds the off-canvas chrome.
+     * @prop side - which edge the panel slides from (default 'right')
+     * @event tlOpen  - the drawer opened
+     * @event tlClose - the drawer closed
+     */
+    interface TlCartDrawer {
+        /**
+          * Heading shown at the top of the panel.
+          * @default 'Your cart'
+         */
+        "heading": string;
+        /**
+          * Controlled open state (also driven by the `ui:cart-requested` intent).
+          * @default false
+         */
+        "open": boolean;
+        /**
+          * Edge the panel slides in from.
+          * @default 'right'
+         */
+        "side": 'right' | 'left';
+    }
+    /**
+     * @component tl-checkout-wrapper
+     * Wraps any content and opens the Ticketlayer checkout modal when clicked.
+     * Uses the SDK's modal manager which handles the iframe overlay.
+     * @example <tl-checkout-wrapper>
+     *   <button>Proceed to Checkout</button>
+     * </tl-checkout-wrapper>
+     */
+    interface TlCheckoutWrapper {
+        /**
+          * Whether the wrapper is disabled
+          * @default false
+         */
+        "disabled": boolean;
+    }
+    interface TlEventCard {
+        /**
+          * Event data to display (tl-event-list passes this)
+         */
+        "event"?: TlEventCardEvent;
+        /**
+          * Load the event from the SDK by id when no `event` is given, so a single card works standalone (e.g. on a Webflow page).
+         */
+        "eventId"?: string;
+    }
+    interface TlEventList {
+        /**
+          * Category filter
+         */
+        "category"?: string;
+        /**
+          * Columns for grid layout (1, 2, 3, or 4)
+          * @default 3
+         */
+        "columns": number;
+        /**
+          * Maximum number of events to display
+          * @default 12
+         */
+        "limit": number;
+    }
+    /**
+     * tl-login - magic-link sign-in. The customer enters an email, we ask the SDK
+     * to send a link (POST /sales/customer-auth/magic-link), then either the link
+     * lands back on this page with `?code=` or the customer types the code from
+     * the email; both exchange through the SDK (POST /sales/customer-tokens). No
+     * password is ever handled here.
+     * States: enter email -> check your inbox (resend, enter code) -> signed in
+     * (email + sign out).
+     * Usage: <tl-login></tl-login>
+     * @event tlAuthChanged  - signed in or out ({ customer, authenticated })
+     * @event tlMagicLinkSent - a link was requested for an email
+     * @event tlError        - request or code exchange failed
+     */
+    interface TlLogin {
+        /**
+          * Offer a "enter the code" path alongside the emailed link (default true).
+          * @default true
+         */
+        "allowCodeEntry": boolean;
+        /**
+          * Heading for the email step.
+          * @default 'Sign in'
+         */
+        "heading": string;
+    }
+    /**
+     * tl-my-orders - the signed-in customer's orders (GET /sales/my-orders through
+     * the SDK): event, date, ticket count, total and status per row. Clicking a
+     * row expands it to show the order's tickets (tl-order-tickets). Shows
+     * tl-login inline when nobody is signed in.
+     * Usage: <tl-my-orders></tl-my-orders>
+     * @event tlOrderSelect - a row was expanded ({ orderId })
+     * @event tlError       - the orders could not be loaded
+     */
+    interface TlMyOrders {
+        /**
+          * Columns for the expanded ticket grid.
+          * @default 2
+         */
+        "columns": number;
+        /**
+          * Copy for the empty state.
+          * @default "When you buy tickets they'll show up here, ready to view and download."
+         */
+        "emptyMessage": string;
+    }
+    interface TlOccurrenceSelector {
+        /**
+          * Force a specific display mode (auto-detected if not set)
+         */
+        "displayMode"?: DisplayMode;
+        /**
+          * Event ID to fetch occurrences for
+         */
+        "eventId": string;
+        /**
+          * Layout orientation (auto = horizontal on desktop, vertical on mobile)
+          * @default 'auto'
+         */
+        "orientation": Orientation;
+        /**
+          * Theme configuration
+         */
+        "theme"?: TlOccurrenceSelectorTheme;
+    }
+    /**
+     * tl-order-confirmation - the "thank you" page block: order reference,
+     * customer email, event and date, ticket lines, totals, then the tickets
+     * themselves (tl-order-tickets, each with a Download PDF link).
+     * Finds its order three ways, in priority order:
+     *  1. the `order-id` prop
+     *  2. the URL (`?orderId=`), the contract the hosted box office confirmation
+     *     page uses; `?redirect_status=` from a Stripe return is honoured too
+     *  3. the SDK's `checkout:completed` event, for a page that mounts this before
+     *     the customer pays
+     * Usage: <tl-order-confirmation order-id="ord_xxx"></tl-order-confirmation>
+     * @event tlOrderLoaded - the order was loaded
+     * @event tlError       - the order could not be loaded
+     */
+    interface TlOrderConfirmation {
+        /**
+          * Columns for the ticket grid.
+          * @default 2
+         */
+        "columns": number;
+        /**
+          * Email to show when the order view carries none (a host that collected it at checkout).
+         */
+        "customerEmail"?: string;
+        /**
+          * The order to show. Falls back to `?orderId=` in the page URL.
+         */
+        "orderId"?: string;
+        /**
+          * Mount tl-order-tickets under the summary (default true).
+          * @default true
+         */
+        "showTickets": boolean;
+    }
+    /**
+     * tl-order-tickets - renders all the tickets for an order as scannable QR
+     * cards with PDF download. Fetches the order through the SDK (order-access
+     * gated by the session), so it works on a confirmation page or in an account.
+     * Usage: <tl-order-tickets order-id="ord_xxx"></tl-order-tickets>
+     */
+    interface TlOrderTickets {
+        /**
+          * Columns in the grid (default 2).
+          * @default 2
+         */
+        "columns": number;
+        /**
+          * The order whose tickets to show.
+         */
+        "orderId": string;
+    }
+    /**
+     * tl-promo-code - an input plus Apply button that redeems a presale or promo
+     * code for the current cart (POST /sales/presale-codes/redeem through the
+     * SDK). Redemption unlocks gated pricing on the customer; the SDK re-reads the
+     * cart and publishes cart:updated, so tl-cart and badges re-render on their own.
+     * The API has no un-redeem, so the applied state offers only "use a different
+     * code", which clears the input for another redemption.
+     * Usage: <tl-promo-code></tl-promo-code>
+     * @event tlPromoApplied - a code was redeemed ({ code, benefit, alreadyHeld, cart })
+     * @event tlError        - the code was rejected
+     */
+    interface TlPromoCode {
+        /**
+          * Apply button label.
+          * @default 'Apply'
+         */
+        "buttonLabel": string;
+        /**
+          * Input placeholder.
+          * @default 'Promo or presale code'
+         */
+        "placeholder": string;
+    }
+    interface TlSeatMap {
+        /**
+          * API URL for the seat map data
+          * @default 'https://api.ticketlayer.com'
+         */
+        "apiUrl": string;
+        /**
+          * Base URL for the hosted seat map (HBO URL)
+          * @default 'https://checkout.ticketlayer.com'
+         */
+        "hboUrl": string;
+        /**
+          * Height of the seat map
+          * @default '600px'
+         */
+        "height": string;
+        /**
+          * Occurrence ID to show seat map for
+         */
+        "occurrenceId": string;
+        /**
+          * Width of the seat map
+          * @default '100%'
+         */
+        "width": string;
+    }
+    /**
+     * tl-ticket - a single event ticket: a scannable QR (the redemption token),
+     * ticket name / seat / holder, and a PDF download. Greys out + stamps
+     * Used/Void when redeemed or cancelled.
+     */
+    interface TlTicket {
+        /**
+          * Order id this ticket belongs to (for the PDF download).
+         */
+        "orderId": string;
+        /**
+          * The ticket to render.
+         */
+        "ticket": TlTicketData;
+    }
+    interface TlTicketSelector {
+        /**
+          * Button label
+          * @default 'Add to Cart'
+         */
+        "buttonLabel": string;
+        /**
+          * Event ID
+         */
+        "eventId": string;
+        /**
+          * Occurrence ID
+         */
+        "occurrenceId": string;
+        /**
+          * Show add to cart button
+          * @default true
+         */
+        "showButton": boolean;
+    }
+}
+export interface TlBuyModalCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlBuyModalElement;
+}
+export interface TlBuyTicketsButtonCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlBuyTicketsButtonElement;
+}
+export interface TlBuyTicketsWrapperCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlBuyTicketsWrapperElement;
+}
+export interface TlCartCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlCartElement;
+}
+export interface TlCartBadgeCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlCartBadgeElement;
+}
+export interface TlCartDrawerCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlCartDrawerElement;
+}
+export interface TlCheckoutWrapperCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlCheckoutWrapperElement;
+}
+export interface TlEventCardCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlEventCardElement;
+}
+export interface TlEventListCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlEventListElement;
+}
+export interface TlLoginCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlLoginElement;
+}
+export interface TlMyOrdersCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlMyOrdersElement;
+}
+export interface TlOccurrenceSelectorCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlOccurrenceSelectorElement;
+}
+export interface TlOrderConfirmationCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlOrderConfirmationElement;
+}
+export interface TlPromoCodeCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlPromoCodeElement;
+}
+export interface TlSeatMapCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlSeatMapElement;
+}
+export interface TlTicketSelectorCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLTlTicketSelectorElement;
+}
+declare global {
+    interface HTMLTlBuyModalElementEventMap {
+        "tlClose": void;
+        "tlCheckout": void;
+        "tlError": { message: string };
+    }
+    /**
+     * @component tl-buy-modal
+     * The in-page buy-tickets funnel: occurrence → ticket selection → added.
+     * A NATIVE Elements overlay (no iframe) - it simply composes the existing
+     * `tl-occurrence-selector` and `tl-ticket-selector`, which already bind to the
+     * SDK and add to the cart. Because it's pure browse/cart (zero PCI surface), it
+     * renders in-page identically on HBO and on any third-party embed bound to
+     * `window.Ticketlayer`. Only the *checkout* step crosses into an iframe.
+     * It is not placed in markup by hosts: the SDK's buy-modal manager mounts it on
+     * demand when something emits `ui:event-modal-requested` (e.g. a
+     * `tl-buy-tickets-button` or a calendar date click), and removes it on close.
+     * @event tlClose    - user dismissed the modal (keep browsing)
+     * @event tlCheckout - user chose to proceed to checkout (manager hands off to
+     *              the checkout intent: iframe on embeds, /checkout on HBO)
+     * @event tlError    - the event couldn't be loaded
+     */
+    interface HTMLTlBuyModalElement extends Components.TlBuyModal, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlBuyModalElementEventMap>(type: K, listener: (this: HTMLTlBuyModalElement, ev: TlBuyModalCustomEvent<HTMLTlBuyModalElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlBuyModalElementEventMap>(type: K, listener: (this: HTMLTlBuyModalElement, ev: TlBuyModalCustomEvent<HTMLTlBuyModalElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlBuyModalElement: {
+        prototype: HTMLTlBuyModalElement;
+        new (): HTMLTlBuyModalElement;
+    };
+    interface HTMLTlBuyTicketsButtonElementEventMap {
+        "tlClick": { eventId: string; occurrenceId?: string };
+    }
+    interface HTMLTlBuyTicketsButtonElement extends Components.TlBuyTicketsButton, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlBuyTicketsButtonElementEventMap>(type: K, listener: (this: HTMLTlBuyTicketsButtonElement, ev: TlBuyTicketsButtonCustomEvent<HTMLTlBuyTicketsButtonElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlBuyTicketsButtonElementEventMap>(type: K, listener: (this: HTMLTlBuyTicketsButtonElement, ev: TlBuyTicketsButtonCustomEvent<HTMLTlBuyTicketsButtonElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlBuyTicketsButtonElement: {
+        prototype: HTMLTlBuyTicketsButtonElement;
+        new (): HTMLTlBuyTicketsButtonElement;
+    };
+    interface HTMLTlBuyTicketsWrapperElementEventMap {
+        "tl-complete": OrderResult;
+        "tl-error": { message: string };
+        "tl-close": void;
+    }
+    /**
+     * @component tl-buy-tickets-wrapper
+     * Wraps any content and opens the Ticketlayer modal when clicked.
+     * Uses the SDK's modal manager which handles the iframe overlay.
+     * @example <tl-buy-tickets-wrapper event-id="evt_001">
+     *   <button>Buy Tickets</button>
+     * </tl-buy-tickets-wrapper>
+     * @example <tl-buy-tickets-wrapper event-id="evt_001" occurrence-id="occ_001">
+     *   <button>Get Tickets for Saturday</button>
+     * </tl-buy-tickets-wrapper>
+     */
+    interface HTMLTlBuyTicketsWrapperElement extends Components.TlBuyTicketsWrapper, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlBuyTicketsWrapperElementEventMap>(type: K, listener: (this: HTMLTlBuyTicketsWrapperElement, ev: TlBuyTicketsWrapperCustomEvent<HTMLTlBuyTicketsWrapperElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlBuyTicketsWrapperElementEventMap>(type: K, listener: (this: HTMLTlBuyTicketsWrapperElement, ev: TlBuyTicketsWrapperCustomEvent<HTMLTlBuyTicketsWrapperElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlBuyTicketsWrapperElement: {
+        prototype: HTMLTlBuyTicketsWrapperElement;
+        new (): HTMLTlBuyTicketsWrapperElement;
+    };
+    interface HTMLTlCartElementEventMap {
+        "tlCheckout": { cart: TlCartData };
+        "tlItemRemoved": { itemId: string };
+        "tlCartUpdated": { cart: TlCartData };
+        "tlError": { message: string };
+    }
+    interface HTMLTlCartElement extends Components.TlCart, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlCartElementEventMap>(type: K, listener: (this: HTMLTlCartElement, ev: TlCartCustomEvent<HTMLTlCartElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlCartElementEventMap>(type: K, listener: (this: HTMLTlCartElement, ev: TlCartCustomEvent<HTMLTlCartElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlCartElement: {
+        prototype: HTMLTlCartElement;
+        new (): HTMLTlCartElement;
+    };
+    interface HTMLTlCartBadgeElementEventMap {
+        "tlClick": { itemCount: number };
+    }
+    interface HTMLTlCartBadgeElement extends Components.TlCartBadge, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlCartBadgeElementEventMap>(type: K, listener: (this: HTMLTlCartBadgeElement, ev: TlCartBadgeCustomEvent<HTMLTlCartBadgeElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlCartBadgeElementEventMap>(type: K, listener: (this: HTMLTlCartBadgeElement, ev: TlCartBadgeCustomEvent<HTMLTlCartBadgeElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlCartBadgeElement: {
+        prototype: HTMLTlCartBadgeElement;
+        new (): HTMLTlCartBadgeElement;
+    };
+    interface HTMLTlCartDrawerElementEventMap {
+        "tlOpen": void;
+        "tlClose": void;
+    }
+    /**
+     * @component tl-cart-drawer
+     * A slide-in cart panel (off-canvas) showing the current cart. It opens when
+     * anything raises the `ui:cart-requested` bus intent - e.g. wire a
+     * `tl-cart-badge`'s click to emit it - and closes on the backdrop, the close
+     * button, Escape, or `ui:modal-close-requested`. The panel embeds `<tl-cart>`,
+     * so the actual cart rendering / remove / checkout is shared with the inline
+     * cart; the drawer only adds the off-canvas chrome.
+     * @prop side - which edge the panel slides from (default 'right')
+     * @event tlOpen  - the drawer opened
+     * @event tlClose - the drawer closed
+     */
+    interface HTMLTlCartDrawerElement extends Components.TlCartDrawer, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlCartDrawerElementEventMap>(type: K, listener: (this: HTMLTlCartDrawerElement, ev: TlCartDrawerCustomEvent<HTMLTlCartDrawerElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlCartDrawerElementEventMap>(type: K, listener: (this: HTMLTlCartDrawerElement, ev: TlCartDrawerCustomEvent<HTMLTlCartDrawerElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlCartDrawerElement: {
+        prototype: HTMLTlCartDrawerElement;
+        new (): HTMLTlCartDrawerElement;
+    };
+    interface HTMLTlCheckoutWrapperElementEventMap {
+        "tl-complete": OrderResult;
+        "tl-error": { message: string };
+        "tl-close": void;
+    }
+    /**
+     * @component tl-checkout-wrapper
+     * Wraps any content and opens the Ticketlayer checkout modal when clicked.
+     * Uses the SDK's modal manager which handles the iframe overlay.
+     * @example <tl-checkout-wrapper>
+     *   <button>Proceed to Checkout</button>
+     * </tl-checkout-wrapper>
+     */
+    interface HTMLTlCheckoutWrapperElement extends Components.TlCheckoutWrapper, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlCheckoutWrapperElementEventMap>(type: K, listener: (this: HTMLTlCheckoutWrapperElement, ev: TlCheckoutWrapperCustomEvent<HTMLTlCheckoutWrapperElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlCheckoutWrapperElementEventMap>(type: K, listener: (this: HTMLTlCheckoutWrapperElement, ev: TlCheckoutWrapperCustomEvent<HTMLTlCheckoutWrapperElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlCheckoutWrapperElement: {
+        prototype: HTMLTlCheckoutWrapperElement;
+        new (): HTMLTlCheckoutWrapperElement;
+    };
+    interface HTMLTlEventCardElementEventMap {
+        "tlClick": { eventId: string };
+        "tlError": { message: string };
+    }
+    interface HTMLTlEventCardElement extends Components.TlEventCard, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlEventCardElementEventMap>(type: K, listener: (this: HTMLTlEventCardElement, ev: TlEventCardCustomEvent<HTMLTlEventCardElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlEventCardElementEventMap>(type: K, listener: (this: HTMLTlEventCardElement, ev: TlEventCardCustomEvent<HTMLTlEventCardElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlEventCardElement: {
+        prototype: HTMLTlEventCardElement;
+        new (): HTMLTlEventCardElement;
+    };
+    interface HTMLTlEventListElementEventMap {
+        "tlEventClick": { eventId: string };
+    }
+    interface HTMLTlEventListElement extends Components.TlEventList, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlEventListElementEventMap>(type: K, listener: (this: HTMLTlEventListElement, ev: TlEventListCustomEvent<HTMLTlEventListElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlEventListElementEventMap>(type: K, listener: (this: HTMLTlEventListElement, ev: TlEventListCustomEvent<HTMLTlEventListElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlEventListElement: {
+        prototype: HTMLTlEventListElement;
+        new (): HTMLTlEventListElement;
+    };
+    interface HTMLTlLoginElementEventMap {
+        "tlAuthChanged": TlAuthChanged;
+        "tlMagicLinkSent": { email: string };
+        "tlError": { message: string };
+    }
+    /**
+     * tl-login - magic-link sign-in. The customer enters an email, we ask the SDK
+     * to send a link (POST /sales/customer-auth/magic-link), then either the link
+     * lands back on this page with `?code=` or the customer types the code from
+     * the email; both exchange through the SDK (POST /sales/customer-tokens). No
+     * password is ever handled here.
+     * States: enter email -> check your inbox (resend, enter code) -> signed in
+     * (email + sign out).
+     * Usage: <tl-login></tl-login>
+     * @event tlAuthChanged  - signed in or out ({ customer, authenticated })
+     * @event tlMagicLinkSent - a link was requested for an email
+     * @event tlError        - request or code exchange failed
+     */
+    interface HTMLTlLoginElement extends Components.TlLogin, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlLoginElementEventMap>(type: K, listener: (this: HTMLTlLoginElement, ev: TlLoginCustomEvent<HTMLTlLoginElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlLoginElementEventMap>(type: K, listener: (this: HTMLTlLoginElement, ev: TlLoginCustomEvent<HTMLTlLoginElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlLoginElement: {
+        prototype: HTMLTlLoginElement;
+        new (): HTMLTlLoginElement;
+    };
+    interface HTMLTlMyOrdersElementEventMap {
+        "tlOrderSelect": { orderId: string };
+        "tlError": { message: string };
+    }
+    /**
+     * tl-my-orders - the signed-in customer's orders (GET /sales/my-orders through
+     * the SDK): event, date, ticket count, total and status per row. Clicking a
+     * row expands it to show the order's tickets (tl-order-tickets). Shows
+     * tl-login inline when nobody is signed in.
+     * Usage: <tl-my-orders></tl-my-orders>
+     * @event tlOrderSelect - a row was expanded ({ orderId })
+     * @event tlError       - the orders could not be loaded
+     */
+    interface HTMLTlMyOrdersElement extends Components.TlMyOrders, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlMyOrdersElementEventMap>(type: K, listener: (this: HTMLTlMyOrdersElement, ev: TlMyOrdersCustomEvent<HTMLTlMyOrdersElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlMyOrdersElementEventMap>(type: K, listener: (this: HTMLTlMyOrdersElement, ev: TlMyOrdersCustomEvent<HTMLTlMyOrdersElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlMyOrdersElement: {
+        prototype: HTMLTlMyOrdersElement;
+        new (): HTMLTlMyOrdersElement;
+    };
+    interface HTMLTlOccurrenceSelectorElementEventMap {
+        "tlSelect": { occurrence: TlOccurrence };
+    }
+    interface HTMLTlOccurrenceSelectorElement extends Components.TlOccurrenceSelector, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlOccurrenceSelectorElementEventMap>(type: K, listener: (this: HTMLTlOccurrenceSelectorElement, ev: TlOccurrenceSelectorCustomEvent<HTMLTlOccurrenceSelectorElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlOccurrenceSelectorElementEventMap>(type: K, listener: (this: HTMLTlOccurrenceSelectorElement, ev: TlOccurrenceSelectorCustomEvent<HTMLTlOccurrenceSelectorElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlOccurrenceSelectorElement: {
+        prototype: HTMLTlOccurrenceSelectorElement;
+        new (): HTMLTlOccurrenceSelectorElement;
+    };
+    interface HTMLTlOrderConfirmationElementEventMap {
+        "tlOrderLoaded": { order: TlOrderData };
+        "tlError": { message: string };
+    }
+    /**
+     * tl-order-confirmation - the "thank you" page block: order reference,
+     * customer email, event and date, ticket lines, totals, then the tickets
+     * themselves (tl-order-tickets, each with a Download PDF link).
+     * Finds its order three ways, in priority order:
+     *  1. the `order-id` prop
+     *  2. the URL (`?orderId=`), the contract the hosted box office confirmation
+     *     page uses; `?redirect_status=` from a Stripe return is honoured too
+     *  3. the SDK's `checkout:completed` event, for a page that mounts this before
+     *     the customer pays
+     * Usage: <tl-order-confirmation order-id="ord_xxx"></tl-order-confirmation>
+     * @event tlOrderLoaded - the order was loaded
+     * @event tlError       - the order could not be loaded
+     */
+    interface HTMLTlOrderConfirmationElement extends Components.TlOrderConfirmation, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlOrderConfirmationElementEventMap>(type: K, listener: (this: HTMLTlOrderConfirmationElement, ev: TlOrderConfirmationCustomEvent<HTMLTlOrderConfirmationElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlOrderConfirmationElementEventMap>(type: K, listener: (this: HTMLTlOrderConfirmationElement, ev: TlOrderConfirmationCustomEvent<HTMLTlOrderConfirmationElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlOrderConfirmationElement: {
+        prototype: HTMLTlOrderConfirmationElement;
+        new (): HTMLTlOrderConfirmationElement;
+    };
+    /**
+     * tl-order-tickets - renders all the tickets for an order as scannable QR
+     * cards with PDF download. Fetches the order through the SDK (order-access
+     * gated by the session), so it works on a confirmation page or in an account.
+     * Usage: <tl-order-tickets order-id="ord_xxx"></tl-order-tickets>
+     */
+    interface HTMLTlOrderTicketsElement extends Components.TlOrderTickets, HTMLStencilElement {
+    }
+    var HTMLTlOrderTicketsElement: {
+        prototype: HTMLTlOrderTicketsElement;
+        new (): HTMLTlOrderTicketsElement;
+    };
+    interface HTMLTlPromoCodeElementEventMap {
+        "tlPromoApplied": TlPromoApplied;
+        "tlError": { message: string };
+    }
+    /**
+     * tl-promo-code - an input plus Apply button that redeems a presale or promo
+     * code for the current cart (POST /sales/presale-codes/redeem through the
+     * SDK). Redemption unlocks gated pricing on the customer; the SDK re-reads the
+     * cart and publishes cart:updated, so tl-cart and badges re-render on their own.
+     * The API has no un-redeem, so the applied state offers only "use a different
+     * code", which clears the input for another redemption.
+     * Usage: <tl-promo-code></tl-promo-code>
+     * @event tlPromoApplied - a code was redeemed ({ code, benefit, alreadyHeld, cart })
+     * @event tlError        - the code was rejected
+     */
+    interface HTMLTlPromoCodeElement extends Components.TlPromoCode, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlPromoCodeElementEventMap>(type: K, listener: (this: HTMLTlPromoCodeElement, ev: TlPromoCodeCustomEvent<HTMLTlPromoCodeElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlPromoCodeElementEventMap>(type: K, listener: (this: HTMLTlPromoCodeElement, ev: TlPromoCodeCustomEvent<HTMLTlPromoCodeElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlPromoCodeElement: {
+        prototype: HTMLTlPromoCodeElement;
+        new (): HTMLTlPromoCodeElement;
+    };
+    interface HTMLTlSeatMapElementEventMap {
+        "tlReady": void;
+        "tlLoad": { seatMapId: string };
+        "tlError": { error: string };
+        "tlSeatAdded": { seatId: string; ticketTypeId: string };
+        "tlSeatRemoved": { seatId: string };
+        "tlCartChange": { seatIds: string[] };
+    }
+    interface HTMLTlSeatMapElement extends Components.TlSeatMap, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlSeatMapElementEventMap>(type: K, listener: (this: HTMLTlSeatMapElement, ev: TlSeatMapCustomEvent<HTMLTlSeatMapElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlSeatMapElementEventMap>(type: K, listener: (this: HTMLTlSeatMapElement, ev: TlSeatMapCustomEvent<HTMLTlSeatMapElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlSeatMapElement: {
+        prototype: HTMLTlSeatMapElement;
+        new (): HTMLTlSeatMapElement;
+    };
+    /**
+     * tl-ticket - a single event ticket: a scannable QR (the redemption token),
+     * ticket name / seat / holder, and a PDF download. Greys out + stamps
+     * Used/Void when redeemed or cancelled.
+     */
+    interface HTMLTlTicketElement extends Components.TlTicket, HTMLStencilElement {
+    }
+    var HTMLTlTicketElement: {
+        prototype: HTMLTlTicketElement;
+        new (): HTMLTlTicketElement;
+    };
+    interface HTMLTlTicketSelectorElementEventMap {
+        "tlAddToCart": { items: AddToCartItem[] };
+        "tlQuantityChange": { ticketTypeId: string; quantity: number; total: number };
+        "tlError": { message: string };
+    }
+    interface HTMLTlTicketSelectorElement extends Components.TlTicketSelector, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLTlTicketSelectorElementEventMap>(type: K, listener: (this: HTMLTlTicketSelectorElement, ev: TlTicketSelectorCustomEvent<HTMLTlTicketSelectorElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLTlTicketSelectorElementEventMap>(type: K, listener: (this: HTMLTlTicketSelectorElement, ev: TlTicketSelectorCustomEvent<HTMLTlTicketSelectorElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLTlTicketSelectorElement: {
+        prototype: HTMLTlTicketSelectorElement;
+        new (): HTMLTlTicketSelectorElement;
+    };
+    interface HTMLElementTagNameMap {
+        "tl-buy-modal": HTMLTlBuyModalElement;
+        "tl-buy-tickets-button": HTMLTlBuyTicketsButtonElement;
+        "tl-buy-tickets-wrapper": HTMLTlBuyTicketsWrapperElement;
+        "tl-cart": HTMLTlCartElement;
+        "tl-cart-badge": HTMLTlCartBadgeElement;
+        "tl-cart-drawer": HTMLTlCartDrawerElement;
+        "tl-checkout-wrapper": HTMLTlCheckoutWrapperElement;
+        "tl-event-card": HTMLTlEventCardElement;
+        "tl-event-list": HTMLTlEventListElement;
+        "tl-login": HTMLTlLoginElement;
+        "tl-my-orders": HTMLTlMyOrdersElement;
+        "tl-occurrence-selector": HTMLTlOccurrenceSelectorElement;
+        "tl-order-confirmation": HTMLTlOrderConfirmationElement;
+        "tl-order-tickets": HTMLTlOrderTicketsElement;
+        "tl-promo-code": HTMLTlPromoCodeElement;
+        "tl-seat-map": HTMLTlSeatMapElement;
+        "tl-ticket": HTMLTlTicketElement;
+        "tl-ticket-selector": HTMLTlTicketSelectorElement;
+    }
+}
+declare namespace LocalJSX {
+    /**
+     * @component tl-buy-modal
+     * The in-page buy-tickets funnel: occurrence → ticket selection → added.
+     * A NATIVE Elements overlay (no iframe) - it simply composes the existing
+     * `tl-occurrence-selector` and `tl-ticket-selector`, which already bind to the
+     * SDK and add to the cart. Because it's pure browse/cart (zero PCI surface), it
+     * renders in-page identically on HBO and on any third-party embed bound to
+     * `window.Ticketlayer`. Only the *checkout* step crosses into an iframe.
+     * It is not placed in markup by hosts: the SDK's buy-modal manager mounts it on
+     * demand when something emits `ui:event-modal-requested` (e.g. a
+     * `tl-buy-tickets-button` or a calendar date click), and removes it on close.
+     * @event tlClose    - user dismissed the modal (keep browsing)
+     * @event tlCheckout - user chose to proceed to checkout (manager hands off to
+     *              the checkout intent: iframe on embeds, /checkout on HBO)
+     * @event tlError    - the event couldn't be loaded
+     */
+    interface TlBuyModal {
+        /**
+          * Event to sell tickets for.
+         */
+        "eventId": string;
+        /**
+          * Optionally open straight to ticket selection for this occurrence.
+         */
+        "occurrenceId"?: string;
+        "onTlCheckout"?: (event: TlBuyModalCustomEvent<void>) => void;
+        "onTlClose"?: (event: TlBuyModalCustomEvent<void>) => void;
+        "onTlError"?: (event: TlBuyModalCustomEvent<{ message: string }>) => void;
+    }
+    interface TlBuyTicketsButton {
+        /**
+          * Currency code for price formatting
+          * @default 'GBP'
+         */
+        "currency"?: string;
+        /**
+          * Disabled state
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Event ID to purchase tickets for
+         */
+        "eventId": string;
+        /**
+          * Full width button
+          * @default false
+         */
+        "fullWidth"?: boolean;
+        /**
+          * Button label override (default depends on state)
+         */
+        "label"?: string;
+        /**
+          * Optional pre-selected occurrence ID
+         */
+        "occurrenceId"?: string;
+        /**
+          * Emitted when button is clicked (before modal opens)
+         */
+        "onTlClick"?: (event: TlBuyTicketsButtonCustomEvent<{ eventId: string; occurrenceId?: string }>) => void;
+        /**
+          * Price to display (in minor units e.g. pence)
+         */
+        "price"?: number;
+        /**
+          * Show price prefix text
+          * @default 'From'
+         */
+        "pricePrefix"?: string;
+        /**
+          * Button size
+          * @default 'md'
+         */
+        "size"?: ButtonSize;
+        /**
+          * Button state - determines colour, label, and icon
+          * @default 'available'
+         */
+        "state"?: ButtonState;
+        /**
+          * Button variant
+          * @default 'primary'
+         */
+        "variant"?: ButtonVariant;
+    }
+    /**
+     * @component tl-buy-tickets-wrapper
+     * Wraps any content and opens the Ticketlayer modal when clicked.
+     * Uses the SDK's modal manager which handles the iframe overlay.
+     * @example <tl-buy-tickets-wrapper event-id="evt_001">
+     *   <button>Buy Tickets</button>
+     * </tl-buy-tickets-wrapper>
+     * @example <tl-buy-tickets-wrapper event-id="evt_001" occurrence-id="occ_001">
+     *   <button>Get Tickets for Saturday</button>
+     * </tl-buy-tickets-wrapper>
+     */
+    interface TlBuyTicketsWrapper {
+        /**
+          * Whether the wrapper is disabled
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * The event ID to purchase tickets for
+         */
+        "eventId": string;
+        /**
+          * Optional specific occurrence ID (skips occurrence selector)
+         */
+        "occurrenceId"?: string;
+        /**
+          * Emitted when the modal closes
+         */
+        "onTl-close"?: (event: TlBuyTicketsWrapperCustomEvent<void>) => void;
+        /**
+          * Emitted when purchase completes successfully
+         */
+        "onTl-complete"?: (event: TlBuyTicketsWrapperCustomEvent<OrderResult>) => void;
+        /**
+          * Emitted when an error occurs
+         */
+        "onTl-error"?: (event: TlBuyTicketsWrapperCustomEvent<{ message: string }>) => void;
+    }
+    interface TlCart {
+        /**
+          * Checkout button label
+          * @default 'Checkout'
+         */
+        "checkoutLabel"?: string;
+        /**
+          * Compact mode - hides some details
+          * @default false
+         */
+        "compact"?: boolean;
+        /**
+          * Emitted when cart is updated
+         */
+        "onTlCartUpdated"?: (event: TlCartCustomEvent<{ cart: TlCartData }>) => void;
+        /**
+          * Emitted when checkout is clicked
+         */
+        "onTlCheckout"?: (event: TlCartCustomEvent<{ cart: TlCartData }>) => void;
+        /**
+          * Emitted on error
+         */
+        "onTlError"?: (event: TlCartCustomEvent<{ message: string }>) => void;
+        /**
+          * Emitted when item is removed
+         */
+        "onTlItemRemoved"?: (event: TlCartCustomEvent<{ itemId: string }>) => void;
+        /**
+          * Show checkout button
+          * @default true
+         */
+        "showCheckoutButton"?: boolean;
+        /**
+          * Show remove item buttons
+          * @default true
+         */
+        "showRemoveButtons"?: boolean;
+    }
+    interface TlCartBadge {
+        /**
+          * Badge only mode - only shows the count bubble, no icon or button
+          * @default false
+         */
+        "badgeOnly"?: boolean;
+        /**
+          * Custom icon (emoji or text). If not provided, uses cart SVG
+         */
+        "icon"?: string;
+        /**
+          * Emitted when the badge is clicked
+         */
+        "onTlClick"?: (event: TlCartBadgeCustomEvent<{ itemCount: number }>) => void;
+        /**
+          * Show the badge even when count is 0
+          * @default false
+         */
+        "showEmpty"?: boolean;
+        /**
+          * Size variant
+          * @default 'md'
+         */
+        "size"?: 'sm' | 'md' | 'lg';
+    }
+    /**
+     * @component tl-cart-drawer
+     * A slide-in cart panel (off-canvas) showing the current cart. It opens when
+     * anything raises the `ui:cart-requested` bus intent - e.g. wire a
+     * `tl-cart-badge`'s click to emit it - and closes on the backdrop, the close
+     * button, Escape, or `ui:modal-close-requested`. The panel embeds `<tl-cart>`,
+     * so the actual cart rendering / remove / checkout is shared with the inline
+     * cart; the drawer only adds the off-canvas chrome.
+     * @prop side - which edge the panel slides from (default 'right')
+     * @event tlOpen  - the drawer opened
+     * @event tlClose - the drawer closed
+     */
+    interface TlCartDrawer {
+        /**
+          * Heading shown at the top of the panel.
+          * @default 'Your cart'
+         */
+        "heading"?: string;
+        "onTlClose"?: (event: TlCartDrawerCustomEvent<void>) => void;
+        "onTlOpen"?: (event: TlCartDrawerCustomEvent<void>) => void;
+        /**
+          * Controlled open state (also driven by the `ui:cart-requested` intent).
+          * @default false
+         */
+        "open"?: boolean;
+        /**
+          * Edge the panel slides in from.
+          * @default 'right'
+         */
+        "side"?: 'right' | 'left';
+    }
+    /**
+     * @component tl-checkout-wrapper
+     * Wraps any content and opens the Ticketlayer checkout modal when clicked.
+     * Uses the SDK's modal manager which handles the iframe overlay.
+     * @example <tl-checkout-wrapper>
+     *   <button>Proceed to Checkout</button>
+     * </tl-checkout-wrapper>
+     */
+    interface TlCheckoutWrapper {
+        /**
+          * Whether the wrapper is disabled
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Emitted when the modal closes
+         */
+        "onTl-close"?: (event: TlCheckoutWrapperCustomEvent<void>) => void;
+        /**
+          * Emitted when checkout completes successfully
+         */
+        "onTl-complete"?: (event: TlCheckoutWrapperCustomEvent<OrderResult>) => void;
+        /**
+          * Emitted when an error occurs
+         */
+        "onTl-error"?: (event: TlCheckoutWrapperCustomEvent<{ message: string }>) => void;
+    }
+    interface TlEventCard {
+        /**
+          * Event data to display (tl-event-list passes this)
+         */
+        "event"?: TlEventCardEvent;
+        /**
+          * Load the event from the SDK by id when no `event` is given, so a single card works standalone (e.g. on a Webflow page).
+         */
+        "eventId"?: string;
+        /**
+          * Emitted when the card is clicked
+         */
+        "onTlClick"?: (event: TlEventCardCustomEvent<{ eventId: string }>) => void;
+        /**
+          * Emitted when the event could not be loaded by id
+         */
+        "onTlError"?: (event: TlEventCardCustomEvent<{ message: string }>) => void;
+    }
+    interface TlEventList {
+        /**
+          * Category filter
+         */
+        "category"?: string;
+        /**
+          * Columns for grid layout (1, 2, 3, or 4)
+          * @default 3
+         */
+        "columns"?: number;
+        /**
+          * Maximum number of events to display
+          * @default 12
+         */
+        "limit"?: number;
+        /**
+          * Emitted when an event card is clicked
+         */
+        "onTlEventClick"?: (event: TlEventListCustomEvent<{ eventId: string }>) => void;
+    }
+    /**
+     * tl-login - magic-link sign-in. The customer enters an email, we ask the SDK
+     * to send a link (POST /sales/customer-auth/magic-link), then either the link
+     * lands back on this page with `?code=` or the customer types the code from
+     * the email; both exchange through the SDK (POST /sales/customer-tokens). No
+     * password is ever handled here.
+     * States: enter email -> check your inbox (resend, enter code) -> signed in
+     * (email + sign out).
+     * Usage: <tl-login></tl-login>
+     * @event tlAuthChanged  - signed in or out ({ customer, authenticated })
+     * @event tlMagicLinkSent - a link was requested for an email
+     * @event tlError        - request or code exchange failed
+     */
+    interface TlLogin {
+        /**
+          * Offer a "enter the code" path alongside the emailed link (default true).
+          * @default true
+         */
+        "allowCodeEntry"?: boolean;
+        /**
+          * Heading for the email step.
+          * @default 'Sign in'
+         */
+        "heading"?: string;
+        "onTlAuthChanged"?: (event: TlLoginCustomEvent<TlAuthChanged>) => void;
+        "onTlError"?: (event: TlLoginCustomEvent<{ message: string }>) => void;
+        "onTlMagicLinkSent"?: (event: TlLoginCustomEvent<{ email: string }>) => void;
+    }
+    /**
+     * tl-my-orders - the signed-in customer's orders (GET /sales/my-orders through
+     * the SDK): event, date, ticket count, total and status per row. Clicking a
+     * row expands it to show the order's tickets (tl-order-tickets). Shows
+     * tl-login inline when nobody is signed in.
+     * Usage: <tl-my-orders></tl-my-orders>
+     * @event tlOrderSelect - a row was expanded ({ orderId })
+     * @event tlError       - the orders could not be loaded
+     */
+    interface TlMyOrders {
+        /**
+          * Columns for the expanded ticket grid.
+          * @default 2
+         */
+        "columns"?: number;
+        /**
+          * Copy for the empty state.
+          * @default "When you buy tickets they'll show up here, ready to view and download."
+         */
+        "emptyMessage"?: string;
+        "onTlError"?: (event: TlMyOrdersCustomEvent<{ message: string }>) => void;
+        "onTlOrderSelect"?: (event: TlMyOrdersCustomEvent<{ orderId: string }>) => void;
+    }
+    interface TlOccurrenceSelector {
+        /**
+          * Force a specific display mode (auto-detected if not set)
+         */
+        "displayMode"?: DisplayMode;
+        /**
+          * Event ID to fetch occurrences for
+         */
+        "eventId": string;
+        /**
+          * Emitted when an occurrence is selected
+         */
+        "onTlSelect"?: (event: TlOccurrenceSelectorCustomEvent<{ occurrence: TlOccurrence }>) => void;
+        /**
+          * Layout orientation (auto = horizontal on desktop, vertical on mobile)
+          * @default 'auto'
+         */
+        "orientation"?: Orientation;
+        /**
+          * Theme configuration
+         */
+        "theme"?: TlOccurrenceSelectorTheme;
+    }
+    /**
+     * tl-order-confirmation - the "thank you" page block: order reference,
+     * customer email, event and date, ticket lines, totals, then the tickets
+     * themselves (tl-order-tickets, each with a Download PDF link).
+     * Finds its order three ways, in priority order:
+     *  1. the `order-id` prop
+     *  2. the URL (`?orderId=`), the contract the hosted box office confirmation
+     *     page uses; `?redirect_status=` from a Stripe return is honoured too
+     *  3. the SDK's `checkout:completed` event, for a page that mounts this before
+     *     the customer pays
+     * Usage: <tl-order-confirmation order-id="ord_xxx"></tl-order-confirmation>
+     * @event tlOrderLoaded - the order was loaded
+     * @event tlError       - the order could not be loaded
+     */
+    interface TlOrderConfirmation {
+        /**
+          * Columns for the ticket grid.
+          * @default 2
+         */
+        "columns"?: number;
+        /**
+          * Email to show when the order view carries none (a host that collected it at checkout).
+         */
+        "customerEmail"?: string;
+        "onTlError"?: (event: TlOrderConfirmationCustomEvent<{ message: string }>) => void;
+        "onTlOrderLoaded"?: (event: TlOrderConfirmationCustomEvent<{ order: TlOrderData }>) => void;
+        /**
+          * The order to show. Falls back to `?orderId=` in the page URL.
+         */
+        "orderId"?: string;
+        /**
+          * Mount tl-order-tickets under the summary (default true).
+          * @default true
+         */
+        "showTickets"?: boolean;
+    }
+    /**
+     * tl-order-tickets - renders all the tickets for an order as scannable QR
+     * cards with PDF download. Fetches the order through the SDK (order-access
+     * gated by the session), so it works on a confirmation page or in an account.
+     * Usage: <tl-order-tickets order-id="ord_xxx"></tl-order-tickets>
+     */
+    interface TlOrderTickets {
+        /**
+          * Columns in the grid (default 2).
+          * @default 2
+         */
+        "columns"?: number;
+        /**
+          * The order whose tickets to show.
+         */
+        "orderId": string;
+    }
+    /**
+     * tl-promo-code - an input plus Apply button that redeems a presale or promo
+     * code for the current cart (POST /sales/presale-codes/redeem through the
+     * SDK). Redemption unlocks gated pricing on the customer; the SDK re-reads the
+     * cart and publishes cart:updated, so tl-cart and badges re-render on their own.
+     * The API has no un-redeem, so the applied state offers only "use a different
+     * code", which clears the input for another redemption.
+     * Usage: <tl-promo-code></tl-promo-code>
+     * @event tlPromoApplied - a code was redeemed ({ code, benefit, alreadyHeld, cart })
+     * @event tlError        - the code was rejected
+     */
+    interface TlPromoCode {
+        /**
+          * Apply button label.
+          * @default 'Apply'
+         */
+        "buttonLabel"?: string;
+        "onTlError"?: (event: TlPromoCodeCustomEvent<{ message: string }>) => void;
+        "onTlPromoApplied"?: (event: TlPromoCodeCustomEvent<TlPromoApplied>) => void;
+        /**
+          * Input placeholder.
+          * @default 'Promo or presale code'
+         */
+        "placeholder"?: string;
+    }
+    interface TlSeatMap {
+        /**
+          * API URL for the seat map data
+          * @default 'https://api.ticketlayer.com'
+         */
+        "apiUrl"?: string;
+        /**
+          * Base URL for the hosted seat map (HBO URL)
+          * @default 'https://checkout.ticketlayer.com'
+         */
+        "hboUrl"?: string;
+        /**
+          * Height of the seat map
+          * @default '600px'
+         */
+        "height"?: string;
+        /**
+          * Occurrence ID to show seat map for
+         */
+        "occurrenceId": string;
+        /**
+          * Emitted when cart seats change
+         */
+        "onTlCartChange"?: (event: TlSeatMapCustomEvent<{ seatIds: string[] }>) => void;
+        /**
+          * Emitted when an error occurs
+         */
+        "onTlError"?: (event: TlSeatMapCustomEvent<{ error: string }>) => void;
+        /**
+          * Emitted when seat map is loaded
+         */
+        "onTlLoad"?: (event: TlSeatMapCustomEvent<{ seatMapId: string }>) => void;
+        /**
+          * Emitted when seat map is ready
+         */
+        "onTlReady"?: (event: TlSeatMapCustomEvent<void>) => void;
+        /**
+          * Emitted when a seat is added to cart
+         */
+        "onTlSeatAdded"?: (event: TlSeatMapCustomEvent<{ seatId: string; ticketTypeId: string }>) => void;
+        /**
+          * Emitted when a seat is removed from cart
+         */
+        "onTlSeatRemoved"?: (event: TlSeatMapCustomEvent<{ seatId: string }>) => void;
+        /**
+          * Width of the seat map
+          * @default '100%'
+         */
+        "width"?: string;
+    }
+    /**
+     * tl-ticket - a single event ticket: a scannable QR (the redemption token),
+     * ticket name / seat / holder, and a PDF download. Greys out + stamps
+     * Used/Void when redeemed or cancelled.
+     */
+    interface TlTicket {
+        /**
+          * Order id this ticket belongs to (for the PDF download).
+         */
+        "orderId": string;
+        /**
+          * The ticket to render.
+         */
+        "ticket": TlTicketData;
+    }
+    interface TlTicketSelector {
+        /**
+          * Button label
+          * @default 'Add to Cart'
+         */
+        "buttonLabel"?: string;
+        /**
+          * Event ID
+         */
+        "eventId": string;
+        /**
+          * Occurrence ID
+         */
+        "occurrenceId": string;
+        /**
+          * Emitted when items are added to cart
+         */
+        "onTlAddToCart"?: (event: TlTicketSelectorCustomEvent<{ items: AddToCartItem[] }>) => void;
+        /**
+          * Emitted on error
+         */
+        "onTlError"?: (event: TlTicketSelectorCustomEvent<{ message: string }>) => void;
+        /**
+          * Emitted when quantity changes
+         */
+        "onTlQuantityChange"?: (event: TlTicketSelectorCustomEvent<{ ticketTypeId: string; quantity: number; total: number }>) => void;
+        /**
+          * Show add to cart button
+          * @default true
+         */
+        "showButton"?: boolean;
+    }
+    interface IntrinsicElements {
+        "tl-buy-modal": TlBuyModal;
+        "tl-buy-tickets-button": TlBuyTicketsButton;
+        "tl-buy-tickets-wrapper": TlBuyTicketsWrapper;
+        "tl-cart": TlCart;
+        "tl-cart-badge": TlCartBadge;
+        "tl-cart-drawer": TlCartDrawer;
+        "tl-checkout-wrapper": TlCheckoutWrapper;
+        "tl-event-card": TlEventCard;
+        "tl-event-list": TlEventList;
+        "tl-login": TlLogin;
+        "tl-my-orders": TlMyOrders;
+        "tl-occurrence-selector": TlOccurrenceSelector;
+        "tl-order-confirmation": TlOrderConfirmation;
+        "tl-order-tickets": TlOrderTickets;
+        "tl-promo-code": TlPromoCode;
+        "tl-seat-map": TlSeatMap;
+        "tl-ticket": TlTicket;
+        "tl-ticket-selector": TlTicketSelector;
+    }
+}
+export { LocalJSX as JSX };
+declare module "@stencil/core" {
+    export namespace JSX {
+        interface IntrinsicElements {
+            /**
+             * @component tl-buy-modal
+             * The in-page buy-tickets funnel: occurrence → ticket selection → added.
+             * A NATIVE Elements overlay (no iframe) - it simply composes the existing
+             * `tl-occurrence-selector` and `tl-ticket-selector`, which already bind to the
+             * SDK and add to the cart. Because it's pure browse/cart (zero PCI surface), it
+             * renders in-page identically on HBO and on any third-party embed bound to
+             * `window.Ticketlayer`. Only the *checkout* step crosses into an iframe.
+             * It is not placed in markup by hosts: the SDK's buy-modal manager mounts it on
+             * demand when something emits `ui:event-modal-requested` (e.g. a
+             * `tl-buy-tickets-button` or a calendar date click), and removes it on close.
+             * @event tlClose    - user dismissed the modal (keep browsing)
+             * @event tlCheckout - user chose to proceed to checkout (manager hands off to
+             *              the checkout intent: iframe on embeds, /checkout on HBO)
+             * @event tlError    - the event couldn't be loaded
+             */
+            "tl-buy-modal": LocalJSX.TlBuyModal & JSXBase.HTMLAttributes<HTMLTlBuyModalElement>;
+            "tl-buy-tickets-button": LocalJSX.TlBuyTicketsButton & JSXBase.HTMLAttributes<HTMLTlBuyTicketsButtonElement>;
+            /**
+             * @component tl-buy-tickets-wrapper
+             * Wraps any content and opens the Ticketlayer modal when clicked.
+             * Uses the SDK's modal manager which handles the iframe overlay.
+             * @example <tl-buy-tickets-wrapper event-id="evt_001">
+             *   <button>Buy Tickets</button>
+             * </tl-buy-tickets-wrapper>
+             * @example <tl-buy-tickets-wrapper event-id="evt_001" occurrence-id="occ_001">
+             *   <button>Get Tickets for Saturday</button>
+             * </tl-buy-tickets-wrapper>
+             */
+            "tl-buy-tickets-wrapper": LocalJSX.TlBuyTicketsWrapper & JSXBase.HTMLAttributes<HTMLTlBuyTicketsWrapperElement>;
+            "tl-cart": LocalJSX.TlCart & JSXBase.HTMLAttributes<HTMLTlCartElement>;
+            "tl-cart-badge": LocalJSX.TlCartBadge & JSXBase.HTMLAttributes<HTMLTlCartBadgeElement>;
+            /**
+             * @component tl-cart-drawer
+             * A slide-in cart panel (off-canvas) showing the current cart. It opens when
+             * anything raises the `ui:cart-requested` bus intent - e.g. wire a
+             * `tl-cart-badge`'s click to emit it - and closes on the backdrop, the close
+             * button, Escape, or `ui:modal-close-requested`. The panel embeds `<tl-cart>`,
+             * so the actual cart rendering / remove / checkout is shared with the inline
+             * cart; the drawer only adds the off-canvas chrome.
+             * @prop side - which edge the panel slides from (default 'right')
+             * @event tlOpen  - the drawer opened
+             * @event tlClose - the drawer closed
+             */
+            "tl-cart-drawer": LocalJSX.TlCartDrawer & JSXBase.HTMLAttributes<HTMLTlCartDrawerElement>;
+            /**
+             * @component tl-checkout-wrapper
+             * Wraps any content and opens the Ticketlayer checkout modal when clicked.
+             * Uses the SDK's modal manager which handles the iframe overlay.
+             * @example <tl-checkout-wrapper>
+             *   <button>Proceed to Checkout</button>
+             * </tl-checkout-wrapper>
+             */
+            "tl-checkout-wrapper": LocalJSX.TlCheckoutWrapper & JSXBase.HTMLAttributes<HTMLTlCheckoutWrapperElement>;
+            "tl-event-card": LocalJSX.TlEventCard & JSXBase.HTMLAttributes<HTMLTlEventCardElement>;
+            "tl-event-list": LocalJSX.TlEventList & JSXBase.HTMLAttributes<HTMLTlEventListElement>;
+            /**
+             * tl-login - magic-link sign-in. The customer enters an email, we ask the SDK
+             * to send a link (POST /sales/customer-auth/magic-link), then either the link
+             * lands back on this page with `?code=` or the customer types the code from
+             * the email; both exchange through the SDK (POST /sales/customer-tokens). No
+             * password is ever handled here.
+             * States: enter email -> check your inbox (resend, enter code) -> signed in
+             * (email + sign out).
+             * Usage: <tl-login></tl-login>
+             * @event tlAuthChanged  - signed in or out ({ customer, authenticated })
+             * @event tlMagicLinkSent - a link was requested for an email
+             * @event tlError        - request or code exchange failed
+             */
+            "tl-login": LocalJSX.TlLogin & JSXBase.HTMLAttributes<HTMLTlLoginElement>;
+            /**
+             * tl-my-orders - the signed-in customer's orders (GET /sales/my-orders through
+             * the SDK): event, date, ticket count, total and status per row. Clicking a
+             * row expands it to show the order's tickets (tl-order-tickets). Shows
+             * tl-login inline when nobody is signed in.
+             * Usage: <tl-my-orders></tl-my-orders>
+             * @event tlOrderSelect - a row was expanded ({ orderId })
+             * @event tlError       - the orders could not be loaded
+             */
+            "tl-my-orders": LocalJSX.TlMyOrders & JSXBase.HTMLAttributes<HTMLTlMyOrdersElement>;
+            "tl-occurrence-selector": LocalJSX.TlOccurrenceSelector & JSXBase.HTMLAttributes<HTMLTlOccurrenceSelectorElement>;
+            /**
+             * tl-order-confirmation - the "thank you" page block: order reference,
+             * customer email, event and date, ticket lines, totals, then the tickets
+             * themselves (tl-order-tickets, each with a Download PDF link).
+             * Finds its order three ways, in priority order:
+             *  1. the `order-id` prop
+             *  2. the URL (`?orderId=`), the contract the hosted box office confirmation
+             *     page uses; `?redirect_status=` from a Stripe return is honoured too
+             *  3. the SDK's `checkout:completed` event, for a page that mounts this before
+             *     the customer pays
+             * Usage: <tl-order-confirmation order-id="ord_xxx"></tl-order-confirmation>
+             * @event tlOrderLoaded - the order was loaded
+             * @event tlError       - the order could not be loaded
+             */
+            "tl-order-confirmation": LocalJSX.TlOrderConfirmation & JSXBase.HTMLAttributes<HTMLTlOrderConfirmationElement>;
+            /**
+             * tl-order-tickets - renders all the tickets for an order as scannable QR
+             * cards with PDF download. Fetches the order through the SDK (order-access
+             * gated by the session), so it works on a confirmation page or in an account.
+             * Usage: <tl-order-tickets order-id="ord_xxx"></tl-order-tickets>
+             */
+            "tl-order-tickets": LocalJSX.TlOrderTickets & JSXBase.HTMLAttributes<HTMLTlOrderTicketsElement>;
+            /**
+             * tl-promo-code - an input plus Apply button that redeems a presale or promo
+             * code for the current cart (POST /sales/presale-codes/redeem through the
+             * SDK). Redemption unlocks gated pricing on the customer; the SDK re-reads the
+             * cart and publishes cart:updated, so tl-cart and badges re-render on their own.
+             * The API has no un-redeem, so the applied state offers only "use a different
+             * code", which clears the input for another redemption.
+             * Usage: <tl-promo-code></tl-promo-code>
+             * @event tlPromoApplied - a code was redeemed ({ code, benefit, alreadyHeld, cart })
+             * @event tlError        - the code was rejected
+             */
+            "tl-promo-code": LocalJSX.TlPromoCode & JSXBase.HTMLAttributes<HTMLTlPromoCodeElement>;
+            "tl-seat-map": LocalJSX.TlSeatMap & JSXBase.HTMLAttributes<HTMLTlSeatMapElement>;
+            /**
+             * tl-ticket - a single event ticket: a scannable QR (the redemption token),
+             * ticket name / seat / holder, and a PDF download. Greys out + stamps
+             * Used/Void when redeemed or cancelled.
+             */
+            "tl-ticket": LocalJSX.TlTicket & JSXBase.HTMLAttributes<HTMLTlTicketElement>;
+            "tl-ticket-selector": LocalJSX.TlTicketSelector & JSXBase.HTMLAttributes<HTMLTlTicketSelectorElement>;
+        }
+    }
+}