@primer-io/primer-js 0.3.12 → 0.5.0

package/dist/jsx/index.d.ts

@@ -244,6 +244,31 @@ export type PortalComponentProps = {
   oneventName?: (e: CustomEvent<CustomEvent>) => void;
 };
 
+export type SelectComponentProps = {
+  /** The name attribute for the select element */
+  name?: string;
+  /** The id attribute for the select element */
+  id?: string;
+  /** The current value of the select */
+  value?: string;
+  /** Whether the select is disabled */
+  disabled?: boolean;
+  /** Whether the select is in an error state */
+  "has-error"?: boolean;
+  /** Placeholder text for the select */
+  placeholder?: string;
+  /** Array of options for the select */
+  options?: SelectOption[];
+  /** Fired when selection changes */
+  onchange?: (e: CustomEvent<CustomEvent>) => void;
+  /** Fired when input value changes */
+  oninput?: (e: CustomEvent<CustomEvent>) => void;
+  /** Fired when select receives focus */
+  onfocus?: (e: CustomEvent<CustomEvent>) => void;
+  /** Fired when select loses focus */
+  onblur?: (e: CustomEvent<CustomEvent>) => void;
+};
+
 export type SpinnerComponentProps = {
   /** Color of the spinner
 Defaults to the design system loader color */
@@ -277,6 +302,30 @@ export type AchPaymentComponentProps = {
   "onprimer-ach-mandate-declined"?: (e: CustomEvent<CustomEvent>) => void;
 };
 
+export type BillingAddressComponentProps = {
+  /** Configuration from SDK Core containing checkoutModules configuration */
+  configuration?: ConfigurationContextType;
+  /** Headless SDK utilities for API methods like setBillingAddress */
+  headlessUtils?: HeadlessUtilsContextType;
+  /** Fired when form data changes */
+  "onprimer-billing-address-change"?: (e: CustomEvent<CustomEvent>) => void;
+  /** Fired when form is submitted */
+  "onprimer-billing-address-submit"?: (e: CustomEvent<CustomEvent>) => void;
+};
+
+export type BlikComponentProps = {
+  /** Payment method configuration */
+  paymentMethod?: InitializedPaymentMethod;
+  /** Disables component interaction when true */
+  disabled?: boolean;
+  /**  */
+  paymentManagers?: InitializedManagersMap;
+  /** Dispatched on successful payment */
+  "onprimer-payment-success"?: (e: CustomEvent<never>) => void;
+  /** Dispatched on payment error */
+  "onprimer-payment-error"?: (e: CustomEvent<never>) => void;
+};
+
 export type CardFormComponentProps = {
   /**  */
   "hide-labels"?: boolean;
@@ -434,7 +483,7 @@ export type CardFormSubmitComponentProps = {
 Falls back to localized default if not explicitly set. */
   buttonText?: string;
   /**  */
-  headlessInstance?: HeadlessUtilsContextType;
+  headlessUtils?: HeadlessUtilsContextType;
   /**  */
   clientOptions?: ClientOptionsContextType;
   /**  */
@@ -831,6 +880,19 @@ export type CustomElements = {
    */
   "primer-portal": Partial<PortalComponentProps & BaseProps & BaseEvents>;
 
+  /**
+   * A native select dropdown component
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **change** - Fired when selection changes
+   * - **input** - Fired when input value changes
+   * - **focus** - Fired when select receives focus
+   * - **blur** - Fired when select loses focus
+   */
+  "primer-select": Partial<SelectComponentProps & BaseProps & BaseEvents>;
+
   /**
    * Spinner component with configurable size and color
    * Adapted to work both standalone and within input components
@@ -852,6 +914,45 @@ export type CustomElements = {
    */
   "primer-ach-payment": Partial<AchPaymentComponentProps & BaseProps & BaseEvents>;
 
+  /**
+   * BillingAddressComponent provides a form for collecting billing address information.
+   *
+   * Configuration is exclusively server-side via SDK Core's checkoutModules. Field visibility
+   * is determined by the BILLING_ADDRESS module in the client session configuration.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **primer-billing-address-change** - Fired when form data changes
+   * - **primer-billing-address-submit** - Fired when form is submitted
+   *
+   * ### **Methods:**
+   *  - **validateForSubmission(): _Promise<boolean>_** - Public method to validate billing address fields
+   * Called by the parent form (card-form) when submitting
+   * Returns true if billing address is valid
+   * Note: Does NOT call setBillingAddress API - that happens after card validation
+   * - **submitToSDK(): _Promise<boolean>_** - Public method to submit billing address to SDK Core
+   * Called by parent form ONLY after both card and billing address validation pass
+   *
+   * Note: headlessUtils is guaranteed to be available when this method is called,
+   * as the component only renders (and becomes interactive) after initialization task completes.
+   */
+  "primer-billing-address": Partial<BillingAddressComponentProps & BaseProps & BaseEvents>;
+
+  /**
+   * BLIK Payment Component
+   *
+   * Consolidated component handling BLIK payment flow from button click through
+   * payment completion. Uses a 4-state machine for managing the user experience.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **primer-payment-success** - Dispatched on successful payment
+   * - **primer-payment-error** - Dispatched on payment error
+   */
+  "primer-blik": Partial<BlikComponentProps & BaseProps & BaseEvents>;
+
   /**
    * CardFormComponent serves as a container for card input components.
    * It handles form submission, validation, and provides context to child components.