@gait-financial/react 0.1.4 → 0.1.5

package/README.md

@@ -71,6 +71,19 @@ function Checkout() {
 
 The button label is always **"Gait"** (with icon). Brand color is fixed to **#4147BF**; split-option styling uses **#F3F2FF**.
 
+## Vite
+
+If using Vite, add this to `vite.config.ts` so the web component script loads correctly:
+
+```ts
+export default defineConfig({
+  optimizeDeps: {
+    exclude: ['@gait-financial/react'],
+  },
+  // ...
+});
+```
+
 ## Next.js
 
 The package uses `"use client"` directives. Import and use in Client Components:

package/dist/index.cjs

@@ -110,6 +110,7 @@ var GaitButton = (0, import_react.forwardRef)(function GaitButton2({
 }, ref) {
   const elementRef = (0, import_react.useRef)(null);
   const [isReady, setIsReady] = (0, import_react.useState)(false);
+  (0, import_react.useImperativeHandle)(ref, () => elementRef.current, []);
   (0, import_react.useEffect)(() => {
     if (typeof customElements !== "undefined" && customElements.get("gait-button")) {
       setIsReady(true);
@@ -117,10 +118,6 @@ var GaitButton = (0, import_react.forwardRef)(function GaitButton2({
     }
     defineCustomElements().then(() => setIsReady(true)).catch(() => setIsReady(false));
   }, []);
-  (0, import_react.useImperativeHandle)(ref, () => elementRef.current, []);
-  if (!isReady) {
-    return null;
-  }
   (0, import_react.useEffect)(() => {
     const el = elementRef.current;
     if (!el) return;
@@ -234,6 +231,9 @@ var GaitButton = (0, import_react.forwardRef)(function GaitButton2({
     onMerchantIdError,
     onConfirm
   ]);
+  if (!isReady) {
+    return null;
+  }
   const passthrough = {};
   if (className) passthrough.className = className;
   if (id) passthrough.id = id;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/components/GaitButton.tsx","../src/register.ts"],"sourcesContent":["'use client';\n\n/**\n * @gait-financial/react - React wrappers for Gait Web Components\n *\n * Usage:\n *   1. Register the Web Component (run once, e.g. in _app.tsx or layout):\n *      import '@gait-financial/react/register';\n *\n *   2. Use the React components:\n *      import { GaitButton } from '@gait-financial/react';\n */\n\nexport { GaitButton } from './components/GaitButton';\nexport type { GaitButtonProps } from './components/GaitButton';\n\nexport type {\n  ButtonSize,\n  GaitButtonItem,\n  GaitPriceBreakdownItem,\n  GaitCustomer,\n  GaitWebhook,\n  GaitClickDetail,\n  GaitLoadedDetail,\n  GaitDataProcessedDetail,\n  GaitSplitFeedbackDetail,\n  GaitMerchantIdErrorDetail,\n  GaitConfirmDetail,\n} from './types';\n","'use client';\n\n/**\n * React wrapper for GaitButton Web Component\n * Maps React props to element attributes (WC uses attributes as source of truth).\n * Uses ref + useEffect for binding - no direct JSX attribute spread to avoid React's\n * string coercion of booleans/objects.\n * Waits for WC registration before rendering to avoid invisible element (race condition).\n */\n\nimport React, {\n  forwardRef,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n} from 'react';\nimport { defineCustomElements } from '../register';\nimport type {\n  GaitButtonItem,\n  GaitPriceBreakdownItem,\n  GaitCustomer,\n  GaitWebhook,\n  GaitClickDetail,\n  GaitLoadedDetail,\n  GaitDataProcessedDetail,\n  GaitSplitFeedbackDetail,\n  GaitMerchantIdErrorDetail,\n  GaitConfirmDetail,\n} from '../types';\n\nexport interface GaitButtonProps\n  extends Omit<React.HTMLAttributes<HTMLElement>, 'onClick' | 'style'> {\n  /** Checkout/data identity (required for payment flow) */\n  'data-id'?: string;\n  /** Disable the button */\n  disabled?: boolean;\n  /** Button size */\n  size?: 'small' | 'medium' | 'large';\n  /** Inline styles - string (for WC) or React.CSSProperties */\n  style?: React.CSSProperties | string;\n  /** Cart/order items for split payment modal */\n  items?: GaitButtonItem[] | string;\n  /** Price breakdown items */\n  priceBreakdown?: GaitPriceBreakdownItem[] | string;\n  /** Total cost */\n  totalCost?: number | string;\n  /** Customer info for split payment */\n  customer?: GaitCustomer | string;\n  /** Webhook config for split payment callbacks */\n  webhook?: GaitWebhook | string;\n  /** Merchant store URL (defaults to window.location.origin) */\n  merchantStoreUrl?: string;\n\n  /** Button clicked */\n  onClick?: (detail: GaitClickDetail) => void;\n  /** Component loaded/rendered */\n  onLoaded?: (detail: GaitLoadedDetail) => void;\n  /** Data processed (e.g. checkoutId resolved) */\n  onDataProcessed?: (detail: GaitDataProcessedDetail) => void;\n  /** Split payment API feedback (success/failure) */\n  onSplitFeedback?: (detail: GaitSplitFeedbackDetail) => void;\n  /** Merchant ID lookup failed */\n  onMerchantIdError?: (detail: GaitMerchantIdErrorDetail) => void;\n  /** Pay remaining confirmed */\n  onConfirm?: (detail: GaitConfirmDetail) => void;\n}\n\nconst GaitButton = forwardRef<HTMLElement, GaitButtonProps>(function GaitButton(\n  {\n    'data-id': dataId,\n    disabled,\n    size,\n    style,\n    items,\n    priceBreakdown,\n    totalCost,\n    customer,\n    webhook,\n    merchantStoreUrl,\n    onClick,\n    onLoaded,\n    onDataProcessed,\n    onSplitFeedback,\n    onMerchantIdError,\n    onConfirm,\n    className,\n    id,\n    ...rest\n  },\n  ref\n) {\n  const elementRef = useRef<HTMLElement>(null);\n  const [isReady, setIsReady] = useState(false);\n\n  // Wait for WC to be registered before rendering (avoids invisible element)\n  useEffect(() => {\n    if (typeof customElements !== 'undefined' && customElements.get('gait-button')) {\n      setIsReady(true);\n      return;\n    }\n    defineCustomElements().then(() => setIsReady(true)).catch(() => setIsReady(false));\n  }, []);\n\n  useImperativeHandle(ref, () => elementRef.current as HTMLElement, []);\n\n  if (!isReady) {\n    return null;\n  }\n\n  // Sync props to element attributes via ref (WC reads attributes)\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el) return;\n\n    if (dataId !== undefined) el.setAttribute('data-id', dataId);\n    if (size !== undefined) el.setAttribute('size', size);\n\n    if (disabled) {\n      el.setAttribute('disabled', '');\n    } else {\n      el.removeAttribute('disabled');\n    }\n\n    if (style !== undefined) {\n      const styleStr =\n        typeof style === 'string'\n          ? style\n          : Object.entries(style)\n              .map(\n                ([k, v]) =>\n                  `${k.replace(/([A-Z])/g, '-$1').toLowerCase()}: ${v}`\n              )\n              .join('; ');\n      el.setAttribute('style', styleStr);\n    }\n\n    if (items !== undefined) {\n      el.setAttribute(\n        'items',\n        typeof items === 'string' ? items : JSON.stringify(items)\n      );\n    }\n\n    if (priceBreakdown !== undefined) {\n      el.setAttribute(\n        'price-breakdown',\n        typeof priceBreakdown === 'string'\n          ? priceBreakdown\n          : JSON.stringify(priceBreakdown)\n      );\n    }\n\n    if (totalCost !== undefined) {\n      el.setAttribute('total-cost', String(totalCost));\n    }\n\n    if (customer !== undefined) {\n      el.setAttribute(\n        'customer',\n        typeof customer === 'string' ? customer : JSON.stringify(customer)\n      );\n    }\n\n    if (webhook !== undefined) {\n      el.setAttribute(\n        'webhook',\n        typeof webhook === 'string' ? webhook : JSON.stringify(webhook)\n      );\n    }\n\n    if (merchantStoreUrl !== undefined) {\n      el.setAttribute('merchant-store-url', merchantStoreUrl);\n    }\n  }, [\n    dataId,\n    disabled,\n    size,\n    style,\n    items,\n    priceBreakdown,\n    totalCost,\n    customer,\n    webhook,\n    merchantStoreUrl,\n  ]);\n\n  // Event listeners\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el) return;\n\n    const handleClick = (e: Event) => {\n      if (onClick && e instanceof CustomEvent && e.detail) {\n        onClick(e.detail as GaitClickDetail);\n      }\n    };\n    const handleLoaded = (e: Event) => {\n      if (onLoaded && e instanceof CustomEvent && e.detail) {\n        onLoaded(e.detail as GaitLoadedDetail);\n      }\n    };\n    const handleDataProcessed = (e: Event) => {\n      if (onDataProcessed && e instanceof CustomEvent && e.detail) {\n        onDataProcessed(e.detail as GaitDataProcessedDetail);\n      }\n    };\n    const handleSplitFeedback = (e: Event) => {\n      if (onSplitFeedback && e instanceof CustomEvent && e.detail) {\n        onSplitFeedback(e.detail as GaitSplitFeedbackDetail);\n      }\n    };\n    const handleMerchantIdError = (e: Event) => {\n      if (onMerchantIdError && e instanceof CustomEvent && e.detail) {\n        onMerchantIdError(e.detail as GaitMerchantIdErrorDetail);\n      }\n    };\n    const handleConfirm = (e: Event) => {\n      if (onConfirm && e instanceof CustomEvent && e.detail) {\n        onConfirm(e.detail as GaitConfirmDetail);\n      }\n    };\n\n    el.addEventListener('gait-click', handleClick as EventListener);\n    el.addEventListener('gait-loaded', handleLoaded as EventListener);\n    el.addEventListener('gait-data-processed', handleDataProcessed as EventListener);\n    el.addEventListener('gait-split-feedback', handleSplitFeedback as EventListener);\n    el.addEventListener('gait-merchant-id-error', handleMerchantIdError as EventListener);\n    el.addEventListener('gait-confirm', handleConfirm as EventListener);\n\n    return () => {\n      el.removeEventListener('gait-click', handleClick as EventListener);\n      el.removeEventListener('gait-loaded', handleLoaded as EventListener);\n      el.removeEventListener('gait-data-processed', handleDataProcessed as EventListener);\n      el.removeEventListener('gait-split-feedback', handleSplitFeedback as EventListener);\n      el.removeEventListener('gait-merchant-id-error', handleMerchantIdError as EventListener);\n      el.removeEventListener('gait-confirm', handleConfirm as EventListener);\n    };\n  }, [\n    onClick,\n    onLoaded,\n    onDataProcessed,\n    onSplitFeedback,\n    onMerchantIdError,\n    onConfirm,\n  ]);\n\n  const passthrough: Record<string, unknown> = {};\n  if (className) passthrough.className = className;\n  if (id) passthrough.id = id;\n  Object.assign(passthrough, rest);\n\n  return React.createElement('gait-button', {\n    ref: elementRef,\n    ...passthrough,\n  });\n});\n\nGaitButton.displayName = 'GaitButton';\n\nexport { GaitButton };\n","/**\n * Registers Gait Web Components in the browser.\n * Safe to call in SSR environments - no-op when window/customElements unavailable.\n *\n * Usage:\n *   import '@gait-financial/react/register';  // Side-effect: registers when in browser\n *   // or\n *   import { defineCustomElements } from '@gait-financial/react/register';\n *   await defineCustomElements();  // Optional: load from custom URL\n */\n\nlet loadPromise: Promise<void> | null = null;\n\n/**\n * Loads and registers Gait Web Components.\n * In browser: loads the WC script if not already registered.\n * In SSR: no-op.\n * Deduplicated: multiple calls return the same promise.\n *\n * @param scriptUrl - Optional URL to the button.js script. If omitted, uses the bundled script.\n */\nexport async function defineCustomElements(\n  scriptUrl?: string\n): Promise<void> {\n  if (typeof window === 'undefined' || typeof customElements === 'undefined') {\n    return;\n  }\n  if (customElements.get('gait-button')) {\n    return;\n  }\n  if (loadPromise) {\n    return loadPromise;\n  }\n\n  const tryLoad = (url: string): Promise<void> =>\n    new Promise((resolve, reject) => {\n      const script = document.createElement('script');\n      script.async = true;\n      script.src = url;\n      script.onload = () => resolve();\n      script.onerror = () => reject();\n      document.head.appendChild(script);\n    });\n\n  loadPromise = (async () => {\n    const fallbackUrl = `${typeof window !== 'undefined' ? window.location.origin : ''}/node_modules/@gait-financial/react/dist/wc/button.js`;\n\n    if (scriptUrl) {\n      await tryLoad(scriptUrl);\n      return;\n    }\n\n    // Try relative to module first (works when not pre-bundled)\n    try {\n      const url = new URL('./wc/button.js', import.meta.url).href;\n      await tryLoad(url);\n      return;\n    } catch {\n      // ignore\n    }\n\n    // Fallback: direct path (works when Vite pre-bundles and breaks import.meta.url)\n    try {\n      await tryLoad(fallbackUrl);\n      return;\n    } catch {\n      throw new Error(\n        '[@gait-financial/react] Failed to load web component script. If using Vite, add optimizeDeps: { exclude: [\"@gait-financial/react\"] } to vite.config.'\n      );\n    }\n  })();\n  return loadPromise;\n}\n\n// Side-effect: auto-register when imported in browser (SSR-safe)\nif (typeof window !== 'undefined' && typeof customElements !== 'undefined') {\n  void defineCustomElements();\n}\n"],"mappings":"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","names":["GaitButton","React"]}
+{"version":3,"sources":["../src/index.ts","../src/components/GaitButton.tsx","../src/register.ts"],"sourcesContent":["'use client';\n\n/**\n * @gait-financial/react - React wrappers for Gait Web Components\n *\n * Usage:\n *   1. Register the Web Component (run once, e.g. in _app.tsx or layout):\n *      import '@gait-financial/react/register';\n *\n *   2. Use the React components:\n *      import { GaitButton } from '@gait-financial/react';\n */\n\nexport { GaitButton } from './components/GaitButton';\nexport type { GaitButtonProps } from './components/GaitButton';\n\nexport type {\n  ButtonSize,\n  GaitButtonItem,\n  GaitPriceBreakdownItem,\n  GaitCustomer,\n  GaitWebhook,\n  GaitClickDetail,\n  GaitLoadedDetail,\n  GaitDataProcessedDetail,\n  GaitSplitFeedbackDetail,\n  GaitMerchantIdErrorDetail,\n  GaitConfirmDetail,\n} from './types';\n","'use client';\n\n/**\n * React wrapper for GaitButton Web Component\n * Maps React props to element attributes (WC uses attributes as source of truth).\n * Uses ref + useEffect for binding - no direct JSX attribute spread to avoid React's\n * string coercion of booleans/objects.\n * Waits for WC registration before rendering to avoid invisible element (race condition).\n */\n\nimport React, {\n  forwardRef,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n} from 'react';\nimport { defineCustomElements } from '../register';\nimport type {\n  GaitButtonItem,\n  GaitPriceBreakdownItem,\n  GaitCustomer,\n  GaitWebhook,\n  GaitClickDetail,\n  GaitLoadedDetail,\n  GaitDataProcessedDetail,\n  GaitSplitFeedbackDetail,\n  GaitMerchantIdErrorDetail,\n  GaitConfirmDetail,\n} from '../types';\n\nexport interface GaitButtonProps\n  extends Omit<React.HTMLAttributes<HTMLElement>, 'onClick' | 'style'> {\n  /** Checkout/data identity (required for payment flow) */\n  'data-id'?: string;\n  /** Disable the button */\n  disabled?: boolean;\n  /** Button size */\n  size?: 'small' | 'medium' | 'large';\n  /** Inline styles - string (for WC) or React.CSSProperties */\n  style?: React.CSSProperties | string;\n  /** Cart/order items for split payment modal */\n  items?: GaitButtonItem[] | string;\n  /** Price breakdown items */\n  priceBreakdown?: GaitPriceBreakdownItem[] | string;\n  /** Total cost */\n  totalCost?: number | string;\n  /** Customer info for split payment */\n  customer?: GaitCustomer | string;\n  /** Webhook config for split payment callbacks */\n  webhook?: GaitWebhook | string;\n  /** Merchant store URL (defaults to window.location.origin) */\n  merchantStoreUrl?: string;\n\n  /** Button clicked */\n  onClick?: (detail: GaitClickDetail) => void;\n  /** Component loaded/rendered */\n  onLoaded?: (detail: GaitLoadedDetail) => void;\n  /** Data processed (e.g. checkoutId resolved) */\n  onDataProcessed?: (detail: GaitDataProcessedDetail) => void;\n  /** Split payment API feedback (success/failure) */\n  onSplitFeedback?: (detail: GaitSplitFeedbackDetail) => void;\n  /** Merchant ID lookup failed */\n  onMerchantIdError?: (detail: GaitMerchantIdErrorDetail) => void;\n  /** Pay remaining confirmed */\n  onConfirm?: (detail: GaitConfirmDetail) => void;\n}\n\nconst GaitButton = forwardRef<HTMLElement, GaitButtonProps>(function GaitButton(\n  {\n    'data-id': dataId,\n    disabled,\n    size,\n    style,\n    items,\n    priceBreakdown,\n    totalCost,\n    customer,\n    webhook,\n    merchantStoreUrl,\n    onClick,\n    onLoaded,\n    onDataProcessed,\n    onSplitFeedback,\n    onMerchantIdError,\n    onConfirm,\n    className,\n    id,\n    ...rest\n  },\n  ref\n) {\n  const elementRef = useRef<HTMLElement>(null);\n  const [isReady, setIsReady] = useState(false);\n\n  useImperativeHandle(ref, () => elementRef.current as HTMLElement, []);\n\n  // Wait for WC to be registered before rendering (avoids invisible element)\n  useEffect(() => {\n    if (typeof customElements !== 'undefined' && customElements.get('gait-button')) {\n      setIsReady(true);\n      return;\n    }\n    defineCustomElements().then(() => setIsReady(true)).catch(() => setIsReady(false));\n  }, []);\n\n  // Sync props to element attributes via ref (WC reads attributes) - must run every render (hooks order)\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el) return;\n\n    if (dataId !== undefined) el.setAttribute('data-id', dataId);\n    if (size !== undefined) el.setAttribute('size', size);\n\n    if (disabled) {\n      el.setAttribute('disabled', '');\n    } else {\n      el.removeAttribute('disabled');\n    }\n\n    if (style !== undefined) {\n      const styleStr =\n        typeof style === 'string'\n          ? style\n          : Object.entries(style)\n              .map(\n                ([k, v]) =>\n                  `${k.replace(/([A-Z])/g, '-$1').toLowerCase()}: ${v}`\n              )\n              .join('; ');\n      el.setAttribute('style', styleStr);\n    }\n\n    if (items !== undefined) {\n      el.setAttribute(\n        'items',\n        typeof items === 'string' ? items : JSON.stringify(items)\n      );\n    }\n\n    if (priceBreakdown !== undefined) {\n      el.setAttribute(\n        'price-breakdown',\n        typeof priceBreakdown === 'string'\n          ? priceBreakdown\n          : JSON.stringify(priceBreakdown)\n      );\n    }\n\n    if (totalCost !== undefined) {\n      el.setAttribute('total-cost', String(totalCost));\n    }\n\n    if (customer !== undefined) {\n      el.setAttribute(\n        'customer',\n        typeof customer === 'string' ? customer : JSON.stringify(customer)\n      );\n    }\n\n    if (webhook !== undefined) {\n      el.setAttribute(\n        'webhook',\n        typeof webhook === 'string' ? webhook : JSON.stringify(webhook)\n      );\n    }\n\n    if (merchantStoreUrl !== undefined) {\n      el.setAttribute('merchant-store-url', merchantStoreUrl);\n    }\n  }, [\n    dataId,\n    disabled,\n    size,\n    style,\n    items,\n    priceBreakdown,\n    totalCost,\n    customer,\n    webhook,\n    merchantStoreUrl,\n  ]);\n\n  // Event listeners\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el) return;\n\n    const handleClick = (e: Event) => {\n      if (onClick && e instanceof CustomEvent && e.detail) {\n        onClick(e.detail as GaitClickDetail);\n      }\n    };\n    const handleLoaded = (e: Event) => {\n      if (onLoaded && e instanceof CustomEvent && e.detail) {\n        onLoaded(e.detail as GaitLoadedDetail);\n      }\n    };\n    const handleDataProcessed = (e: Event) => {\n      if (onDataProcessed && e instanceof CustomEvent && e.detail) {\n        onDataProcessed(e.detail as GaitDataProcessedDetail);\n      }\n    };\n    const handleSplitFeedback = (e: Event) => {\n      if (onSplitFeedback && e instanceof CustomEvent && e.detail) {\n        onSplitFeedback(e.detail as GaitSplitFeedbackDetail);\n      }\n    };\n    const handleMerchantIdError = (e: Event) => {\n      if (onMerchantIdError && e instanceof CustomEvent && e.detail) {\n        onMerchantIdError(e.detail as GaitMerchantIdErrorDetail);\n      }\n    };\n    const handleConfirm = (e: Event) => {\n      if (onConfirm && e instanceof CustomEvent && e.detail) {\n        onConfirm(e.detail as GaitConfirmDetail);\n      }\n    };\n\n    el.addEventListener('gait-click', handleClick as EventListener);\n    el.addEventListener('gait-loaded', handleLoaded as EventListener);\n    el.addEventListener('gait-data-processed', handleDataProcessed as EventListener);\n    el.addEventListener('gait-split-feedback', handleSplitFeedback as EventListener);\n    el.addEventListener('gait-merchant-id-error', handleMerchantIdError as EventListener);\n    el.addEventListener('gait-confirm', handleConfirm as EventListener);\n\n    return () => {\n      el.removeEventListener('gait-click', handleClick as EventListener);\n      el.removeEventListener('gait-loaded', handleLoaded as EventListener);\n      el.removeEventListener('gait-data-processed', handleDataProcessed as EventListener);\n      el.removeEventListener('gait-split-feedback', handleSplitFeedback as EventListener);\n      el.removeEventListener('gait-merchant-id-error', handleMerchantIdError as EventListener);\n      el.removeEventListener('gait-confirm', handleConfirm as EventListener);\n    };\n  }, [\n    onClick,\n    onLoaded,\n    onDataProcessed,\n    onSplitFeedback,\n    onMerchantIdError,\n    onConfirm,\n  ]);\n\n  // Conditional render AFTER all hooks - required by Rules of Hooks\n  if (!isReady) {\n    return null;\n  }\n\n  const passthrough: Record<string, unknown> = {};\n  if (className) passthrough.className = className;\n  if (id) passthrough.id = id;\n  Object.assign(passthrough, rest);\n\n  return React.createElement('gait-button', {\n    ref: elementRef,\n    ...passthrough,\n  });\n});\n\nGaitButton.displayName = 'GaitButton';\n\nexport { GaitButton };\n","/**\n * Registers Gait Web Components in the browser.\n * Safe to call in SSR environments - no-op when window/customElements unavailable.\n *\n * Usage:\n *   import '@gait-financial/react/register';  // Side-effect: registers when in browser\n *   // or\n *   import { defineCustomElements } from '@gait-financial/react/register';\n *   await defineCustomElements();  // Optional: load from custom URL\n */\n\nlet loadPromise: Promise<void> | null = null;\n\n/**\n * Loads and registers Gait Web Components.\n * In browser: loads the WC script if not already registered.\n * In SSR: no-op.\n * Deduplicated: multiple calls return the same promise.\n *\n * @param scriptUrl - Optional URL to the button.js script. If omitted, uses the bundled script.\n */\nexport async function defineCustomElements(\n  scriptUrl?: string\n): Promise<void> {\n  if (typeof window === 'undefined' || typeof customElements === 'undefined') {\n    return;\n  }\n  if (customElements.get('gait-button')) {\n    return;\n  }\n  if (loadPromise) {\n    return loadPromise;\n  }\n\n  const tryLoad = (url: string): Promise<void> =>\n    new Promise((resolve, reject) => {\n      const script = document.createElement('script');\n      script.async = true;\n      script.src = url;\n      script.onload = () => resolve();\n      script.onerror = () => reject();\n      document.head.appendChild(script);\n    });\n\n  loadPromise = (async () => {\n    const fallbackUrl = `${typeof window !== 'undefined' ? window.location.origin : ''}/node_modules/@gait-financial/react/dist/wc/button.js`;\n\n    if (scriptUrl) {\n      await tryLoad(scriptUrl);\n      return;\n    }\n\n    // Try relative to module first (works when not pre-bundled)\n    try {\n      const url = new URL('./wc/button.js', import.meta.url).href;\n      await tryLoad(url);\n      return;\n    } catch {\n      // ignore\n    }\n\n    // Fallback: direct path (works when Vite pre-bundles and breaks import.meta.url)\n    try {\n      await tryLoad(fallbackUrl);\n      return;\n    } catch {\n      throw new Error(\n        '[@gait-financial/react] Failed to load web component script. If using Vite, add optimizeDeps: { exclude: [\"@gait-financial/react\"] } to vite.config.'\n      );\n    }\n  })();\n  return loadPromise;\n}\n\n// Side-effect: auto-register when imported in browser (SSR-safe)\nif (typeof window !== 'undefined' && typeof customElements !== 'undefined') {\n  void defineCustomElements();\n}\n"],"mappings":"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","names":["GaitButton","React"]}

package/dist/index.js

@@ -80,6 +80,7 @@ var GaitButton = forwardRef(function GaitButton2({
 }, ref) {
   const elementRef = useRef(null);
   const [isReady, setIsReady] = useState(false);
+  useImperativeHandle(ref, () => elementRef.current, []);
   useEffect(() => {
     if (typeof customElements !== "undefined" && customElements.get("gait-button")) {
       setIsReady(true);
@@ -87,10 +88,6 @@ var GaitButton = forwardRef(function GaitButton2({
     }
     defineCustomElements().then(() => setIsReady(true)).catch(() => setIsReady(false));
   }, []);
-  useImperativeHandle(ref, () => elementRef.current, []);
-  if (!isReady) {
-    return null;
-  }
   useEffect(() => {
     const el = elementRef.current;
     if (!el) return;
@@ -204,6 +201,9 @@ var GaitButton = forwardRef(function GaitButton2({
     onMerchantIdError,
     onConfirm
   ]);
+  if (!isReady) {
+    return null;
+  }
   const passthrough = {};
   if (className) passthrough.className = className;
   if (id) passthrough.id = id;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/GaitButton.tsx","../src/register.ts"],"sourcesContent":["'use client';\n\n/**\n * React wrapper for GaitButton Web Component\n * Maps React props to element attributes (WC uses attributes as source of truth).\n * Uses ref + useEffect for binding - no direct JSX attribute spread to avoid React's\n * string coercion of booleans/objects.\n * Waits for WC registration before rendering to avoid invisible element (race condition).\n */\n\nimport React, {\n  forwardRef,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n} from 'react';\nimport { defineCustomElements } from '../register';\nimport type {\n  GaitButtonItem,\n  GaitPriceBreakdownItem,\n  GaitCustomer,\n  GaitWebhook,\n  GaitClickDetail,\n  GaitLoadedDetail,\n  GaitDataProcessedDetail,\n  GaitSplitFeedbackDetail,\n  GaitMerchantIdErrorDetail,\n  GaitConfirmDetail,\n} from '../types';\n\nexport interface GaitButtonProps\n  extends Omit<React.HTMLAttributes<HTMLElement>, 'onClick' | 'style'> {\n  /** Checkout/data identity (required for payment flow) */\n  'data-id'?: string;\n  /** Disable the button */\n  disabled?: boolean;\n  /** Button size */\n  size?: 'small' | 'medium' | 'large';\n  /** Inline styles - string (for WC) or React.CSSProperties */\n  style?: React.CSSProperties | string;\n  /** Cart/order items for split payment modal */\n  items?: GaitButtonItem[] | string;\n  /** Price breakdown items */\n  priceBreakdown?: GaitPriceBreakdownItem[] | string;\n  /** Total cost */\n  totalCost?: number | string;\n  /** Customer info for split payment */\n  customer?: GaitCustomer | string;\n  /** Webhook config for split payment callbacks */\n  webhook?: GaitWebhook | string;\n  /** Merchant store URL (defaults to window.location.origin) */\n  merchantStoreUrl?: string;\n\n  /** Button clicked */\n  onClick?: (detail: GaitClickDetail) => void;\n  /** Component loaded/rendered */\n  onLoaded?: (detail: GaitLoadedDetail) => void;\n  /** Data processed (e.g. checkoutId resolved) */\n  onDataProcessed?: (detail: GaitDataProcessedDetail) => void;\n  /** Split payment API feedback (success/failure) */\n  onSplitFeedback?: (detail: GaitSplitFeedbackDetail) => void;\n  /** Merchant ID lookup failed */\n  onMerchantIdError?: (detail: GaitMerchantIdErrorDetail) => void;\n  /** Pay remaining confirmed */\n  onConfirm?: (detail: GaitConfirmDetail) => void;\n}\n\nconst GaitButton = forwardRef<HTMLElement, GaitButtonProps>(function GaitButton(\n  {\n    'data-id': dataId,\n    disabled,\n    size,\n    style,\n    items,\n    priceBreakdown,\n    totalCost,\n    customer,\n    webhook,\n    merchantStoreUrl,\n    onClick,\n    onLoaded,\n    onDataProcessed,\n    onSplitFeedback,\n    onMerchantIdError,\n    onConfirm,\n    className,\n    id,\n    ...rest\n  },\n  ref\n) {\n  const elementRef = useRef<HTMLElement>(null);\n  const [isReady, setIsReady] = useState(false);\n\n  // Wait for WC to be registered before rendering (avoids invisible element)\n  useEffect(() => {\n    if (typeof customElements !== 'undefined' && customElements.get('gait-button')) {\n      setIsReady(true);\n      return;\n    }\n    defineCustomElements().then(() => setIsReady(true)).catch(() => setIsReady(false));\n  }, []);\n\n  useImperativeHandle(ref, () => elementRef.current as HTMLElement, []);\n\n  if (!isReady) {\n    return null;\n  }\n\n  // Sync props to element attributes via ref (WC reads attributes)\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el) return;\n\n    if (dataId !== undefined) el.setAttribute('data-id', dataId);\n    if (size !== undefined) el.setAttribute('size', size);\n\n    if (disabled) {\n      el.setAttribute('disabled', '');\n    } else {\n      el.removeAttribute('disabled');\n    }\n\n    if (style !== undefined) {\n      const styleStr =\n        typeof style === 'string'\n          ? style\n          : Object.entries(style)\n              .map(\n                ([k, v]) =>\n                  `${k.replace(/([A-Z])/g, '-$1').toLowerCase()}: ${v}`\n              )\n              .join('; ');\n      el.setAttribute('style', styleStr);\n    }\n\n    if (items !== undefined) {\n      el.setAttribute(\n        'items',\n        typeof items === 'string' ? items : JSON.stringify(items)\n      );\n    }\n\n    if (priceBreakdown !== undefined) {\n      el.setAttribute(\n        'price-breakdown',\n        typeof priceBreakdown === 'string'\n          ? priceBreakdown\n          : JSON.stringify(priceBreakdown)\n      );\n    }\n\n    if (totalCost !== undefined) {\n      el.setAttribute('total-cost', String(totalCost));\n    }\n\n    if (customer !== undefined) {\n      el.setAttribute(\n        'customer',\n        typeof customer === 'string' ? customer : JSON.stringify(customer)\n      );\n    }\n\n    if (webhook !== undefined) {\n      el.setAttribute(\n        'webhook',\n        typeof webhook === 'string' ? webhook : JSON.stringify(webhook)\n      );\n    }\n\n    if (merchantStoreUrl !== undefined) {\n      el.setAttribute('merchant-store-url', merchantStoreUrl);\n    }\n  }, [\n    dataId,\n    disabled,\n    size,\n    style,\n    items,\n    priceBreakdown,\n    totalCost,\n    customer,\n    webhook,\n    merchantStoreUrl,\n  ]);\n\n  // Event listeners\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el) return;\n\n    const handleClick = (e: Event) => {\n      if (onClick && e instanceof CustomEvent && e.detail) {\n        onClick(e.detail as GaitClickDetail);\n      }\n    };\n    const handleLoaded = (e: Event) => {\n      if (onLoaded && e instanceof CustomEvent && e.detail) {\n        onLoaded(e.detail as GaitLoadedDetail);\n      }\n    };\n    const handleDataProcessed = (e: Event) => {\n      if (onDataProcessed && e instanceof CustomEvent && e.detail) {\n        onDataProcessed(e.detail as GaitDataProcessedDetail);\n      }\n    };\n    const handleSplitFeedback = (e: Event) => {\n      if (onSplitFeedback && e instanceof CustomEvent && e.detail) {\n        onSplitFeedback(e.detail as GaitSplitFeedbackDetail);\n      }\n    };\n    const handleMerchantIdError = (e: Event) => {\n      if (onMerchantIdError && e instanceof CustomEvent && e.detail) {\n        onMerchantIdError(e.detail as GaitMerchantIdErrorDetail);\n      }\n    };\n    const handleConfirm = (e: Event) => {\n      if (onConfirm && e instanceof CustomEvent && e.detail) {\n        onConfirm(e.detail as GaitConfirmDetail);\n      }\n    };\n\n    el.addEventListener('gait-click', handleClick as EventListener);\n    el.addEventListener('gait-loaded', handleLoaded as EventListener);\n    el.addEventListener('gait-data-processed', handleDataProcessed as EventListener);\n    el.addEventListener('gait-split-feedback', handleSplitFeedback as EventListener);\n    el.addEventListener('gait-merchant-id-error', handleMerchantIdError as EventListener);\n    el.addEventListener('gait-confirm', handleConfirm as EventListener);\n\n    return () => {\n      el.removeEventListener('gait-click', handleClick as EventListener);\n      el.removeEventListener('gait-loaded', handleLoaded as EventListener);\n      el.removeEventListener('gait-data-processed', handleDataProcessed as EventListener);\n      el.removeEventListener('gait-split-feedback', handleSplitFeedback as EventListener);\n      el.removeEventListener('gait-merchant-id-error', handleMerchantIdError as EventListener);\n      el.removeEventListener('gait-confirm', handleConfirm as EventListener);\n    };\n  }, [\n    onClick,\n    onLoaded,\n    onDataProcessed,\n    onSplitFeedback,\n    onMerchantIdError,\n    onConfirm,\n  ]);\n\n  const passthrough: Record<string, unknown> = {};\n  if (className) passthrough.className = className;\n  if (id) passthrough.id = id;\n  Object.assign(passthrough, rest);\n\n  return React.createElement('gait-button', {\n    ref: elementRef,\n    ...passthrough,\n  });\n});\n\nGaitButton.displayName = 'GaitButton';\n\nexport { GaitButton };\n","/**\n * Registers Gait Web Components in the browser.\n * Safe to call in SSR environments - no-op when window/customElements unavailable.\n *\n * Usage:\n *   import '@gait-financial/react/register';  // Side-effect: registers when in browser\n *   // or\n *   import { defineCustomElements } from '@gait-financial/react/register';\n *   await defineCustomElements();  // Optional: load from custom URL\n */\n\nlet loadPromise: Promise<void> | null = null;\n\n/**\n * Loads and registers Gait Web Components.\n * In browser: loads the WC script if not already registered.\n * In SSR: no-op.\n * Deduplicated: multiple calls return the same promise.\n *\n * @param scriptUrl - Optional URL to the button.js script. If omitted, uses the bundled script.\n */\nexport async function defineCustomElements(\n  scriptUrl?: string\n): Promise<void> {\n  if (typeof window === 'undefined' || typeof customElements === 'undefined') {\n    return;\n  }\n  if (customElements.get('gait-button')) {\n    return;\n  }\n  if (loadPromise) {\n    return loadPromise;\n  }\n\n  const tryLoad = (url: string): Promise<void> =>\n    new Promise((resolve, reject) => {\n      const script = document.createElement('script');\n      script.async = true;\n      script.src = url;\n      script.onload = () => resolve();\n      script.onerror = () => reject();\n      document.head.appendChild(script);\n    });\n\n  loadPromise = (async () => {\n    const fallbackUrl = `${typeof window !== 'undefined' ? window.location.origin : ''}/node_modules/@gait-financial/react/dist/wc/button.js`;\n\n    if (scriptUrl) {\n      await tryLoad(scriptUrl);\n      return;\n    }\n\n    // Try relative to module first (works when not pre-bundled)\n    try {\n      const url = new URL('./wc/button.js', import.meta.url).href;\n      await tryLoad(url);\n      return;\n    } catch {\n      // ignore\n    }\n\n    // Fallback: direct path (works when Vite pre-bundles and breaks import.meta.url)\n    try {\n      await tryLoad(fallbackUrl);\n      return;\n    } catch {\n      throw new Error(\n        '[@gait-financial/react] Failed to load web component script. If using Vite, add optimizeDeps: { exclude: [\"@gait-financial/react\"] } to vite.config.'\n      );\n    }\n  })();\n  return loadPromise;\n}\n\n// Side-effect: auto-register when imported in browser (SSR-safe)\nif (typeof window !== 'undefined' && typeof customElements !== 'undefined') {\n  void defineCustomElements();\n}\n"],"mappings":"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","names":["GaitButton"]}
+{"version":3,"sources":["../src/components/GaitButton.tsx","../src/register.ts"],"sourcesContent":["'use client';\n\n/**\n * React wrapper for GaitButton Web Component\n * Maps React props to element attributes (WC uses attributes as source of truth).\n * Uses ref + useEffect for binding - no direct JSX attribute spread to avoid React's\n * string coercion of booleans/objects.\n * Waits for WC registration before rendering to avoid invisible element (race condition).\n */\n\nimport React, {\n  forwardRef,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n} from 'react';\nimport { defineCustomElements } from '../register';\nimport type {\n  GaitButtonItem,\n  GaitPriceBreakdownItem,\n  GaitCustomer,\n  GaitWebhook,\n  GaitClickDetail,\n  GaitLoadedDetail,\n  GaitDataProcessedDetail,\n  GaitSplitFeedbackDetail,\n  GaitMerchantIdErrorDetail,\n  GaitConfirmDetail,\n} from '../types';\n\nexport interface GaitButtonProps\n  extends Omit<React.HTMLAttributes<HTMLElement>, 'onClick' | 'style'> {\n  /** Checkout/data identity (required for payment flow) */\n  'data-id'?: string;\n  /** Disable the button */\n  disabled?: boolean;\n  /** Button size */\n  size?: 'small' | 'medium' | 'large';\n  /** Inline styles - string (for WC) or React.CSSProperties */\n  style?: React.CSSProperties | string;\n  /** Cart/order items for split payment modal */\n  items?: GaitButtonItem[] | string;\n  /** Price breakdown items */\n  priceBreakdown?: GaitPriceBreakdownItem[] | string;\n  /** Total cost */\n  totalCost?: number | string;\n  /** Customer info for split payment */\n  customer?: GaitCustomer | string;\n  /** Webhook config for split payment callbacks */\n  webhook?: GaitWebhook | string;\n  /** Merchant store URL (defaults to window.location.origin) */\n  merchantStoreUrl?: string;\n\n  /** Button clicked */\n  onClick?: (detail: GaitClickDetail) => void;\n  /** Component loaded/rendered */\n  onLoaded?: (detail: GaitLoadedDetail) => void;\n  /** Data processed (e.g. checkoutId resolved) */\n  onDataProcessed?: (detail: GaitDataProcessedDetail) => void;\n  /** Split payment API feedback (success/failure) */\n  onSplitFeedback?: (detail: GaitSplitFeedbackDetail) => void;\n  /** Merchant ID lookup failed */\n  onMerchantIdError?: (detail: GaitMerchantIdErrorDetail) => void;\n  /** Pay remaining confirmed */\n  onConfirm?: (detail: GaitConfirmDetail) => void;\n}\n\nconst GaitButton = forwardRef<HTMLElement, GaitButtonProps>(function GaitButton(\n  {\n    'data-id': dataId,\n    disabled,\n    size,\n    style,\n    items,\n    priceBreakdown,\n    totalCost,\n    customer,\n    webhook,\n    merchantStoreUrl,\n    onClick,\n    onLoaded,\n    onDataProcessed,\n    onSplitFeedback,\n    onMerchantIdError,\n    onConfirm,\n    className,\n    id,\n    ...rest\n  },\n  ref\n) {\n  const elementRef = useRef<HTMLElement>(null);\n  const [isReady, setIsReady] = useState(false);\n\n  useImperativeHandle(ref, () => elementRef.current as HTMLElement, []);\n\n  // Wait for WC to be registered before rendering (avoids invisible element)\n  useEffect(() => {\n    if (typeof customElements !== 'undefined' && customElements.get('gait-button')) {\n      setIsReady(true);\n      return;\n    }\n    defineCustomElements().then(() => setIsReady(true)).catch(() => setIsReady(false));\n  }, []);\n\n  // Sync props to element attributes via ref (WC reads attributes) - must run every render (hooks order)\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el) return;\n\n    if (dataId !== undefined) el.setAttribute('data-id', dataId);\n    if (size !== undefined) el.setAttribute('size', size);\n\n    if (disabled) {\n      el.setAttribute('disabled', '');\n    } else {\n      el.removeAttribute('disabled');\n    }\n\n    if (style !== undefined) {\n      const styleStr =\n        typeof style === 'string'\n          ? style\n          : Object.entries(style)\n              .map(\n                ([k, v]) =>\n                  `${k.replace(/([A-Z])/g, '-$1').toLowerCase()}: ${v}`\n              )\n              .join('; ');\n      el.setAttribute('style', styleStr);\n    }\n\n    if (items !== undefined) {\n      el.setAttribute(\n        'items',\n        typeof items === 'string' ? items : JSON.stringify(items)\n      );\n    }\n\n    if (priceBreakdown !== undefined) {\n      el.setAttribute(\n        'price-breakdown',\n        typeof priceBreakdown === 'string'\n          ? priceBreakdown\n          : JSON.stringify(priceBreakdown)\n      );\n    }\n\n    if (totalCost !== undefined) {\n      el.setAttribute('total-cost', String(totalCost));\n    }\n\n    if (customer !== undefined) {\n      el.setAttribute(\n        'customer',\n        typeof customer === 'string' ? customer : JSON.stringify(customer)\n      );\n    }\n\n    if (webhook !== undefined) {\n      el.setAttribute(\n        'webhook',\n        typeof webhook === 'string' ? webhook : JSON.stringify(webhook)\n      );\n    }\n\n    if (merchantStoreUrl !== undefined) {\n      el.setAttribute('merchant-store-url', merchantStoreUrl);\n    }\n  }, [\n    dataId,\n    disabled,\n    size,\n    style,\n    items,\n    priceBreakdown,\n    totalCost,\n    customer,\n    webhook,\n    merchantStoreUrl,\n  ]);\n\n  // Event listeners\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el) return;\n\n    const handleClick = (e: Event) => {\n      if (onClick && e instanceof CustomEvent && e.detail) {\n        onClick(e.detail as GaitClickDetail);\n      }\n    };\n    const handleLoaded = (e: Event) => {\n      if (onLoaded && e instanceof CustomEvent && e.detail) {\n        onLoaded(e.detail as GaitLoadedDetail);\n      }\n    };\n    const handleDataProcessed = (e: Event) => {\n      if (onDataProcessed && e instanceof CustomEvent && e.detail) {\n        onDataProcessed(e.detail as GaitDataProcessedDetail);\n      }\n    };\n    const handleSplitFeedback = (e: Event) => {\n      if (onSplitFeedback && e instanceof CustomEvent && e.detail) {\n        onSplitFeedback(e.detail as GaitSplitFeedbackDetail);\n      }\n    };\n    const handleMerchantIdError = (e: Event) => {\n      if (onMerchantIdError && e instanceof CustomEvent && e.detail) {\n        onMerchantIdError(e.detail as GaitMerchantIdErrorDetail);\n      }\n    };\n    const handleConfirm = (e: Event) => {\n      if (onConfirm && e instanceof CustomEvent && e.detail) {\n        onConfirm(e.detail as GaitConfirmDetail);\n      }\n    };\n\n    el.addEventListener('gait-click', handleClick as EventListener);\n    el.addEventListener('gait-loaded', handleLoaded as EventListener);\n    el.addEventListener('gait-data-processed', handleDataProcessed as EventListener);\n    el.addEventListener('gait-split-feedback', handleSplitFeedback as EventListener);\n    el.addEventListener('gait-merchant-id-error', handleMerchantIdError as EventListener);\n    el.addEventListener('gait-confirm', handleConfirm as EventListener);\n\n    return () => {\n      el.removeEventListener('gait-click', handleClick as EventListener);\n      el.removeEventListener('gait-loaded', handleLoaded as EventListener);\n      el.removeEventListener('gait-data-processed', handleDataProcessed as EventListener);\n      el.removeEventListener('gait-split-feedback', handleSplitFeedback as EventListener);\n      el.removeEventListener('gait-merchant-id-error', handleMerchantIdError as EventListener);\n      el.removeEventListener('gait-confirm', handleConfirm as EventListener);\n    };\n  }, [\n    onClick,\n    onLoaded,\n    onDataProcessed,\n    onSplitFeedback,\n    onMerchantIdError,\n    onConfirm,\n  ]);\n\n  // Conditional render AFTER all hooks - required by Rules of Hooks\n  if (!isReady) {\n    return null;\n  }\n\n  const passthrough: Record<string, unknown> = {};\n  if (className) passthrough.className = className;\n  if (id) passthrough.id = id;\n  Object.assign(passthrough, rest);\n\n  return React.createElement('gait-button', {\n    ref: elementRef,\n    ...passthrough,\n  });\n});\n\nGaitButton.displayName = 'GaitButton';\n\nexport { GaitButton };\n","/**\n * Registers Gait Web Components in the browser.\n * Safe to call in SSR environments - no-op when window/customElements unavailable.\n *\n * Usage:\n *   import '@gait-financial/react/register';  // Side-effect: registers when in browser\n *   // or\n *   import { defineCustomElements } from '@gait-financial/react/register';\n *   await defineCustomElements();  // Optional: load from custom URL\n */\n\nlet loadPromise: Promise<void> | null = null;\n\n/**\n * Loads and registers Gait Web Components.\n * In browser: loads the WC script if not already registered.\n * In SSR: no-op.\n * Deduplicated: multiple calls return the same promise.\n *\n * @param scriptUrl - Optional URL to the button.js script. If omitted, uses the bundled script.\n */\nexport async function defineCustomElements(\n  scriptUrl?: string\n): Promise<void> {\n  if (typeof window === 'undefined' || typeof customElements === 'undefined') {\n    return;\n  }\n  if (customElements.get('gait-button')) {\n    return;\n  }\n  if (loadPromise) {\n    return loadPromise;\n  }\n\n  const tryLoad = (url: string): Promise<void> =>\n    new Promise((resolve, reject) => {\n      const script = document.createElement('script');\n      script.async = true;\n      script.src = url;\n      script.onload = () => resolve();\n      script.onerror = () => reject();\n      document.head.appendChild(script);\n    });\n\n  loadPromise = (async () => {\n    const fallbackUrl = `${typeof window !== 'undefined' ? window.location.origin : ''}/node_modules/@gait-financial/react/dist/wc/button.js`;\n\n    if (scriptUrl) {\n      await tryLoad(scriptUrl);\n      return;\n    }\n\n    // Try relative to module first (works when not pre-bundled)\n    try {\n      const url = new URL('./wc/button.js', import.meta.url).href;\n      await tryLoad(url);\n      return;\n    } catch {\n      // ignore\n    }\n\n    // Fallback: direct path (works when Vite pre-bundles and breaks import.meta.url)\n    try {\n      await tryLoad(fallbackUrl);\n      return;\n    } catch {\n      throw new Error(\n        '[@gait-financial/react] Failed to load web component script. If using Vite, add optimizeDeps: { exclude: [\"@gait-financial/react\"] } to vite.config.'\n      );\n    }\n  })();\n  return loadPromise;\n}\n\n// Side-effect: auto-register when imported in browser (SSR-safe)\nif (typeof window !== 'undefined' && typeof customElements !== 'undefined') {\n  void defineCustomElements();\n}\n"],"mappings":"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","names":["GaitButton"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gait-financial/react",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "private": false,
   "description": "React wrappers for Gait Web Components",
   "type": "module",