@ticketlayer/elements 0.3.2 → 0.4.0

package/dist/types/components.d.ts

@@ -436,6 +436,14 @@ export namespace Components {
          */
         "ticket": TlTicketData;
     }
+    /**
+     * The web harness for `ticketSelectorCore`.
+     * It renders and it forwards: every decision, every string and every sum is in
+     * `@ticketlayer/elements-core` (AGENTS.md, TKT-11). What is left here is the
+     * Stencil surface a host writes HTML against - the tag, the attributes, the
+     * three `tl*` events - plus the one thing that is genuinely web: finding the
+     * client the page published on `window.Ticketlayer`.
+     */
     interface TlTicketSelector {
         /**
           * Button label
@@ -932,6 +940,14 @@ declare global {
         "tlQuantityChange": { ticketTypeId: string; quantity: number; total: number };
         "tlError": { message: string };
     }
+    /**
+     * The web harness for `ticketSelectorCore`.
+     * It renders and it forwards: every decision, every string and every sum is in
+     * `@ticketlayer/elements-core` (AGENTS.md, TKT-11). What is left here is the
+     * Stencil surface a host writes HTML against - the tag, the attributes, the
+     * three `tl*` events - plus the one thing that is genuinely web: finding the
+     * client the page published on `window.Ticketlayer`.
+     */
     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;
@@ -968,6 +984,8 @@ declare global {
     }
 }
 declare namespace LocalJSX {
+    type OneOf<K extends string, PropT, AttrT = PropT> = { [P in K]: PropT } & { [P in `attr:${K}`]?: never } | { [P in `attr:${K}`]: AttrT } & { [P in K]?: never };
+
     /**
      * @component tl-buy-modal
      * The in-page buy-tickets funnel: occurrence → ticket selection → added.
@@ -1480,6 +1498,14 @@ declare namespace LocalJSX {
          */
         "ticket": TlTicketData;
     }
+    /**
+     * The web harness for `ticketSelectorCore`.
+     * It renders and it forwards: every decision, every string and every sum is in
+     * `@ticketlayer/elements-core` (AGENTS.md, TKT-11). What is left here is the
+     * Stencil surface a host writes HTML against - the tag, the attributes, the
+     * three `tl*` events - plus the one thing that is genuinely web: finding the
+     * client the page published on `window.Ticketlayer`.
+     */
     interface TlTicketSelector {
         /**
           * Button label
@@ -1512,25 +1538,120 @@ declare namespace LocalJSX {
          */
         "showButton"?: boolean;
     }
+
+    interface TlBuyModalAttributes {
+        "eventId": string;
+        "occurrenceId": string;
+    }
+    interface TlBuyTicketsButtonAttributes {
+        "eventId": string;
+        "occurrenceId": string;
+        "state": ButtonState;
+        "label": string;
+        "variant": ButtonVariant;
+        "size": ButtonSize;
+        "fullWidth": boolean;
+        "price": number;
+        "currency": string;
+        "pricePrefix": string;
+        "disabled": boolean;
+    }
+    interface TlBuyTicketsWrapperAttributes {
+        "eventId": string;
+        "occurrenceId": string;
+        "disabled": boolean;
+    }
+    interface TlCartAttributes {
+        "showCheckoutButton": boolean;
+        "checkoutLabel": string;
+        "showRemoveButtons": boolean;
+        "compact": boolean;
+    }
+    interface TlCartBadgeAttributes {
+        "showEmpty": boolean;
+        "icon": string;
+        "size": 'sm' | 'md' | 'lg';
+        "badgeOnly": boolean;
+    }
+    interface TlCartDrawerAttributes {
+        "side": 'right' | 'left';
+        "heading": string;
+        "open": boolean;
+    }
+    interface TlCheckoutWrapperAttributes {
+        "disabled": boolean;
+    }
+    interface TlEventCardAttributes {
+        "eventId": string;
+    }
+    interface TlEventListAttributes {
+        "limit": number;
+        "category": string;
+        "columns": number;
+    }
+    interface TlLoginAttributes {
+        "heading": string;
+        "allowCodeEntry": boolean;
+    }
+    interface TlMyOrdersAttributes {
+        "emptyMessage": string;
+        "columns": number;
+    }
+    interface TlOccurrenceSelectorAttributes {
+        "eventId": string;
+        "displayMode": DisplayMode;
+        "orientation": Orientation;
+    }
+    interface TlOrderConfirmationAttributes {
+        "orderId": string;
+        "customerEmail": string;
+        "showTickets": boolean;
+        "columns": number;
+    }
+    interface TlOrderTicketsAttributes {
+        "orderId": string;
+        "columns": number;
+    }
+    interface TlPromoCodeAttributes {
+        "placeholder": string;
+        "buttonLabel": string;
+    }
+    interface TlSeatMapAttributes {
+        "occurrenceId": string;
+        "hboUrl": string;
+        "apiUrl": string;
+        "height": string;
+        "width": string;
+    }
+    interface TlTicketAttributes {
+        "orderId": string;
+    }
+    interface TlTicketSelectorAttributes {
+        "eventId": string;
+        "occurrenceId": string;
+        "showButton": boolean;
+        "buttonLabel": string;
+    }
+
     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;
+        "tl-buy-modal": Omit<TlBuyModal, keyof TlBuyModalAttributes> & { [K in keyof TlBuyModal & keyof TlBuyModalAttributes]?: TlBuyModal[K] } & { [K in keyof TlBuyModal & keyof TlBuyModalAttributes as `attr:${K}`]?: TlBuyModalAttributes[K] } & { [K in keyof TlBuyModal & keyof TlBuyModalAttributes as `prop:${K}`]?: TlBuyModal[K] } & OneOf<"eventId", TlBuyModal["eventId"], TlBuyModalAttributes["eventId"]>;
+        "tl-buy-tickets-button": Omit<TlBuyTicketsButton, keyof TlBuyTicketsButtonAttributes> & { [K in keyof TlBuyTicketsButton & keyof TlBuyTicketsButtonAttributes]?: TlBuyTicketsButton[K] } & { [K in keyof TlBuyTicketsButton & keyof TlBuyTicketsButtonAttributes as `attr:${K}`]?: TlBuyTicketsButtonAttributes[K] } & { [K in keyof TlBuyTicketsButton & keyof TlBuyTicketsButtonAttributes as `prop:${K}`]?: TlBuyTicketsButton[K] } & OneOf<"eventId", TlBuyTicketsButton["eventId"], TlBuyTicketsButtonAttributes["eventId"]>;
+        "tl-buy-tickets-wrapper": Omit<TlBuyTicketsWrapper, keyof TlBuyTicketsWrapperAttributes> & { [K in keyof TlBuyTicketsWrapper & keyof TlBuyTicketsWrapperAttributes]?: TlBuyTicketsWrapper[K] } & { [K in keyof TlBuyTicketsWrapper & keyof TlBuyTicketsWrapperAttributes as `attr:${K}`]?: TlBuyTicketsWrapperAttributes[K] } & { [K in keyof TlBuyTicketsWrapper & keyof TlBuyTicketsWrapperAttributes as `prop:${K}`]?: TlBuyTicketsWrapper[K] } & OneOf<"eventId", TlBuyTicketsWrapper["eventId"], TlBuyTicketsWrapperAttributes["eventId"]>;
+        "tl-cart": Omit<TlCart, keyof TlCartAttributes> & { [K in keyof TlCart & keyof TlCartAttributes]?: TlCart[K] } & { [K in keyof TlCart & keyof TlCartAttributes as `attr:${K}`]?: TlCartAttributes[K] } & { [K in keyof TlCart & keyof TlCartAttributes as `prop:${K}`]?: TlCart[K] };
+        "tl-cart-badge": Omit<TlCartBadge, keyof TlCartBadgeAttributes> & { [K in keyof TlCartBadge & keyof TlCartBadgeAttributes]?: TlCartBadge[K] } & { [K in keyof TlCartBadge & keyof TlCartBadgeAttributes as `attr:${K}`]?: TlCartBadgeAttributes[K] } & { [K in keyof TlCartBadge & keyof TlCartBadgeAttributes as `prop:${K}`]?: TlCartBadge[K] };
+        "tl-cart-drawer": Omit<TlCartDrawer, keyof TlCartDrawerAttributes> & { [K in keyof TlCartDrawer & keyof TlCartDrawerAttributes]?: TlCartDrawer[K] } & { [K in keyof TlCartDrawer & keyof TlCartDrawerAttributes as `attr:${K}`]?: TlCartDrawerAttributes[K] } & { [K in keyof TlCartDrawer & keyof TlCartDrawerAttributes as `prop:${K}`]?: TlCartDrawer[K] };
+        "tl-checkout-wrapper": Omit<TlCheckoutWrapper, keyof TlCheckoutWrapperAttributes> & { [K in keyof TlCheckoutWrapper & keyof TlCheckoutWrapperAttributes]?: TlCheckoutWrapper[K] } & { [K in keyof TlCheckoutWrapper & keyof TlCheckoutWrapperAttributes as `attr:${K}`]?: TlCheckoutWrapperAttributes[K] } & { [K in keyof TlCheckoutWrapper & keyof TlCheckoutWrapperAttributes as `prop:${K}`]?: TlCheckoutWrapper[K] };
+        "tl-event-card": Omit<TlEventCard, keyof TlEventCardAttributes> & { [K in keyof TlEventCard & keyof TlEventCardAttributes]?: TlEventCard[K] } & { [K in keyof TlEventCard & keyof TlEventCardAttributes as `attr:${K}`]?: TlEventCardAttributes[K] } & { [K in keyof TlEventCard & keyof TlEventCardAttributes as `prop:${K}`]?: TlEventCard[K] };
+        "tl-event-list": Omit<TlEventList, keyof TlEventListAttributes> & { [K in keyof TlEventList & keyof TlEventListAttributes]?: TlEventList[K] } & { [K in keyof TlEventList & keyof TlEventListAttributes as `attr:${K}`]?: TlEventListAttributes[K] } & { [K in keyof TlEventList & keyof TlEventListAttributes as `prop:${K}`]?: TlEventList[K] };
+        "tl-login": Omit<TlLogin, keyof TlLoginAttributes> & { [K in keyof TlLogin & keyof TlLoginAttributes]?: TlLogin[K] } & { [K in keyof TlLogin & keyof TlLoginAttributes as `attr:${K}`]?: TlLoginAttributes[K] } & { [K in keyof TlLogin & keyof TlLoginAttributes as `prop:${K}`]?: TlLogin[K] };
+        "tl-my-orders": Omit<TlMyOrders, keyof TlMyOrdersAttributes> & { [K in keyof TlMyOrders & keyof TlMyOrdersAttributes]?: TlMyOrders[K] } & { [K in keyof TlMyOrders & keyof TlMyOrdersAttributes as `attr:${K}`]?: TlMyOrdersAttributes[K] } & { [K in keyof TlMyOrders & keyof TlMyOrdersAttributes as `prop:${K}`]?: TlMyOrders[K] };
+        "tl-occurrence-selector": Omit<TlOccurrenceSelector, keyof TlOccurrenceSelectorAttributes> & { [K in keyof TlOccurrenceSelector & keyof TlOccurrenceSelectorAttributes]?: TlOccurrenceSelector[K] } & { [K in keyof TlOccurrenceSelector & keyof TlOccurrenceSelectorAttributes as `attr:${K}`]?: TlOccurrenceSelectorAttributes[K] } & { [K in keyof TlOccurrenceSelector & keyof TlOccurrenceSelectorAttributes as `prop:${K}`]?: TlOccurrenceSelector[K] } & OneOf<"eventId", TlOccurrenceSelector["eventId"], TlOccurrenceSelectorAttributes["eventId"]>;
+        "tl-order-confirmation": Omit<TlOrderConfirmation, keyof TlOrderConfirmationAttributes> & { [K in keyof TlOrderConfirmation & keyof TlOrderConfirmationAttributes]?: TlOrderConfirmation[K] } & { [K in keyof TlOrderConfirmation & keyof TlOrderConfirmationAttributes as `attr:${K}`]?: TlOrderConfirmationAttributes[K] } & { [K in keyof TlOrderConfirmation & keyof TlOrderConfirmationAttributes as `prop:${K}`]?: TlOrderConfirmation[K] };
+        "tl-order-tickets": Omit<TlOrderTickets, keyof TlOrderTicketsAttributes> & { [K in keyof TlOrderTickets & keyof TlOrderTicketsAttributes]?: TlOrderTickets[K] } & { [K in keyof TlOrderTickets & keyof TlOrderTicketsAttributes as `attr:${K}`]?: TlOrderTicketsAttributes[K] } & { [K in keyof TlOrderTickets & keyof TlOrderTicketsAttributes as `prop:${K}`]?: TlOrderTickets[K] } & OneOf<"orderId", TlOrderTickets["orderId"], TlOrderTicketsAttributes["orderId"]>;
+        "tl-promo-code": Omit<TlPromoCode, keyof TlPromoCodeAttributes> & { [K in keyof TlPromoCode & keyof TlPromoCodeAttributes]?: TlPromoCode[K] } & { [K in keyof TlPromoCode & keyof TlPromoCodeAttributes as `attr:${K}`]?: TlPromoCodeAttributes[K] } & { [K in keyof TlPromoCode & keyof TlPromoCodeAttributes as `prop:${K}`]?: TlPromoCode[K] };
+        "tl-seat-map": Omit<TlSeatMap, keyof TlSeatMapAttributes> & { [K in keyof TlSeatMap & keyof TlSeatMapAttributes]?: TlSeatMap[K] } & { [K in keyof TlSeatMap & keyof TlSeatMapAttributes as `attr:${K}`]?: TlSeatMapAttributes[K] } & { [K in keyof TlSeatMap & keyof TlSeatMapAttributes as `prop:${K}`]?: TlSeatMap[K] } & OneOf<"occurrenceId", TlSeatMap["occurrenceId"], TlSeatMapAttributes["occurrenceId"]>;
+        "tl-ticket": Omit<TlTicket, keyof TlTicketAttributes> & { [K in keyof TlTicket & keyof TlTicketAttributes]?: TlTicket[K] } & { [K in keyof TlTicket & keyof TlTicketAttributes as `attr:${K}`]?: TlTicketAttributes[K] } & { [K in keyof TlTicket & keyof TlTicketAttributes as `prop:${K}`]?: TlTicket[K] } & OneOf<"orderId", TlTicket["orderId"], TlTicketAttributes["orderId"]>;
+        "tl-ticket-selector": Omit<TlTicketSelector, keyof TlTicketSelectorAttributes> & { [K in keyof TlTicketSelector & keyof TlTicketSelectorAttributes]?: TlTicketSelector[K] } & { [K in keyof TlTicketSelector & keyof TlTicketSelectorAttributes as `attr:${K}`]?: TlTicketSelectorAttributes[K] } & { [K in keyof TlTicketSelector & keyof TlTicketSelectorAttributes as `prop:${K}`]?: TlTicketSelector[K] } & OneOf<"eventId", TlTicketSelector["eventId"], TlTicketSelectorAttributes["eventId"]> & OneOf<"occurrenceId", TlTicketSelector["occurrenceId"], TlTicketSelectorAttributes["occurrenceId"]>;
     }
 }
 export { LocalJSX as JSX };
@@ -1553,8 +1674,8 @@ declare module "@stencil/core" {
              *              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>;
+            "tl-buy-modal": LocalJSX.IntrinsicElements["tl-buy-modal"] & JSXBase.HTMLAttributes<HTMLTlBuyModalElement>;
+            "tl-buy-tickets-button": LocalJSX.IntrinsicElements["tl-buy-tickets-button"] & JSXBase.HTMLAttributes<HTMLTlBuyTicketsButtonElement>;
             /**
              * @component tl-buy-tickets-wrapper
              * Wraps any content and opens the Ticketlayer modal when clicked.
@@ -1566,9 +1687,9 @@ declare module "@stencil/core" {
              *   <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>;
+            "tl-buy-tickets-wrapper": LocalJSX.IntrinsicElements["tl-buy-tickets-wrapper"] & JSXBase.HTMLAttributes<HTMLTlBuyTicketsWrapperElement>;
+            "tl-cart": LocalJSX.IntrinsicElements["tl-cart"] & JSXBase.HTMLAttributes<HTMLTlCartElement>;
+            "tl-cart-badge": LocalJSX.IntrinsicElements["tl-cart-badge"] & JSXBase.HTMLAttributes<HTMLTlCartBadgeElement>;
             /**
              * @component tl-cart-drawer
              * A slide-in cart panel (off-canvas) showing the current cart. It opens when
@@ -1581,7 +1702,7 @@ declare module "@stencil/core" {
              * @event tlOpen  - the drawer opened
              * @event tlClose - the drawer closed
              */
-            "tl-cart-drawer": LocalJSX.TlCartDrawer & JSXBase.HTMLAttributes<HTMLTlCartDrawerElement>;
+            "tl-cart-drawer": LocalJSX.IntrinsicElements["tl-cart-drawer"] & JSXBase.HTMLAttributes<HTMLTlCartDrawerElement>;
             /**
              * @component tl-checkout-wrapper
              * Wraps any content and opens the Ticketlayer checkout modal when clicked.
@@ -1590,9 +1711,9 @@ declare module "@stencil/core" {
              *   <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-checkout-wrapper": LocalJSX.IntrinsicElements["tl-checkout-wrapper"] & JSXBase.HTMLAttributes<HTMLTlCheckoutWrapperElement>;
+            "tl-event-card": LocalJSX.IntrinsicElements["tl-event-card"] & JSXBase.HTMLAttributes<HTMLTlEventCardElement>;
+            "tl-event-list": LocalJSX.IntrinsicElements["tl-event-list"] & 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
@@ -1606,7 +1727,7 @@ declare module "@stencil/core" {
              * @event tlMagicLinkSent - a link was requested for an email
              * @event tlError        - request or code exchange failed
              */
-            "tl-login": LocalJSX.TlLogin & JSXBase.HTMLAttributes<HTMLTlLoginElement>;
+            "tl-login": LocalJSX.IntrinsicElements["tl-login"] & 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
@@ -1616,8 +1737,8 @@ declare module "@stencil/core" {
              * @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-my-orders": LocalJSX.IntrinsicElements["tl-my-orders"] & JSXBase.HTMLAttributes<HTMLTlMyOrdersElement>;
+            "tl-occurrence-selector": LocalJSX.IntrinsicElements["tl-occurrence-selector"] & JSXBase.HTMLAttributes<HTMLTlOccurrenceSelectorElement>;
             /**
              * tl-order-confirmation - the "thank you" page block: order reference,
              * customer email, event and date, ticket lines, totals, then the tickets
@@ -1632,7 +1753,7 @@ declare module "@stencil/core" {
              * @event tlOrderLoaded - the order was loaded
              * @event tlError       - the order could not be loaded
              */
-            "tl-order-confirmation": LocalJSX.TlOrderConfirmation & JSXBase.HTMLAttributes<HTMLTlOrderConfirmationElement>;
+            "tl-order-confirmation": LocalJSX.IntrinsicElements["tl-order-confirmation"] & 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
@@ -1651,7 +1772,7 @@ declare module "@stencil/core" {
              * coming by email, because at that point something probably is wrong and a
              * page that polls forever is worse than one that admits it.
              */
-            "tl-order-tickets": LocalJSX.TlOrderTickets & JSXBase.HTMLAttributes<HTMLTlOrderTicketsElement>;
+            "tl-order-tickets": LocalJSX.IntrinsicElements["tl-order-tickets"] & 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
@@ -1663,15 +1784,23 @@ declare module "@stencil/core" {
              * @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-promo-code": LocalJSX.IntrinsicElements["tl-promo-code"] & JSXBase.HTMLAttributes<HTMLTlPromoCodeElement>;
+            "tl-seat-map": LocalJSX.IntrinsicElements["tl-seat-map"] & 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>;
+            "tl-ticket": LocalJSX.IntrinsicElements["tl-ticket"] & JSXBase.HTMLAttributes<HTMLTlTicketElement>;
+            /**
+             * The web harness for `ticketSelectorCore`.
+             * It renders and it forwards: every decision, every string and every sum is in
+             * `@ticketlayer/elements-core` (AGENTS.md, TKT-11). What is left here is the
+             * Stencil surface a host writes HTML against - the tag, the attributes, the
+             * three `tl*` events - plus the one thing that is genuinely web: finding the
+             * client the page published on `window.Ticketlayer`.
+             */
+            "tl-ticket-selector": LocalJSX.IntrinsicElements["tl-ticket-selector"] & JSXBase.HTMLAttributes<HTMLTlTicketSelectorElement>;
         }
     }
 }