@liquidcommerce/elements-sdk 2.6.0-beta.40 → 2.6.0-beta.42

package/docs/address.md

@@ -1,242 +0,0 @@
-# Address
-
-The address component manages the customer's delivery location. This determines which products are available, their pricing, and fulfillment options. Most implementations don't need to interact with this directly - it's built into the product component.
-
-## Overview
-
-The address element powers location-aware shopping:
-- Customers enter their delivery address
-- The SDK fetches location-specific inventory and pricing
-- Fulfillment options update based on what's available in that area
-- The address persists across sessions for returning customers
-
-**Important:** You typically don't need to inject this component separately. The address input is embedded within the product component by default. Use standalone injection only for dedicated "enter your address" landing pages.
-
----
-
-## Declarative Setup (HTML Attributes)
-
-In most cases, the address component is automatically managed within the product element. No separate configuration is required.
-
-When you inject a product element, customers can:
-1. Click to enter their delivery address
-2. See real-time availability and pricing for their location
-3. Have their address remembered for future visits
-
-The address UI appears as part of the product component's fulfillment section.
-
----
-
-## Programmatic Setup (JavaScript API)
-
-For standalone address collection (e.g., a "Check Availability" page), inject the address element directly.
-
-### Basic Injection
-
-```javascript
-const client = await Elements('YOUR_API_KEY', { env: 'production' });
-
-const component = await client.injectAddressElement('address-container');
-```
-
-### Return Value
-
-Returns `IInjectedComponent | null`:
-
-```javascript
-if (component) {
-  // Get the container element
-  const element = component.getElement();
-
-  // Get the component type
-  const type = component.getType(); // 'address'
-
-  // Force a re-render
-  component.rerender();
-}
-```
-
----
-
-## Actions
-
-Control address state programmatically. Useful for:
-- Pre-filling addresses for logged-in customers
-- Custom address form integrations
-- Single-click address selection
-
-### Set Address by Google Places ID
-
-Set the delivery location using a Google Places ID:
-
-```javascript
-await window.elements.actions.address.setAddressByPlacesId('ChIJN1t_tDeuEmsRUsoyG83frY4');
-```
-
-### Set Address Manually
-
-Set the delivery location with explicit address data and coordinates:
-
-```javascript
-await window.elements.actions.address.setAddressManually(
-  {
-    one: '123 Main St',      // Street address line 1
-    two: 'Apt 4B',           // Street address line 2 (optional)
-    city: 'New York',
-    state: 'NY',
-    zip: '10001',
-    country: 'US'            // Optional, defaults to US
-  },
-  {
-    lat: 40.7128,            // Latitude
-    long: -74.0060           // Longitude
-  }
-);
-```
-
-### Get Address Details
-
-Retrieve the currently saved address:
-
-```javascript
-const address = window.elements.actions.address.getDetails();
-
-if (address) {
-  console.log(address.formattedAddress);
-  console.log(address.coordinates);
-}
-```
-
-Returns `IAddressData | null`.
-
-### Clear Address
-
-Remove the saved address. **Note:** This also clears the cart since pricing and availability are location-dependent.
-
-```javascript
-await window.elements.actions.address.clear();
-```
-
----
-
-## Events
-
-Listen to address changes for analytics or custom UI updates.
-
-### Subscribing to Events
-
-```javascript
-window.addEventListener('lce:actions.address_updated', (event) => {
-  const { formattedAddress, coordinates } = event.detail.data;
-  console.log('Address set to:', formattedAddress);
-});
-```
-
-### Available Events
-
-| Event | Description | Key Data |
-|-------|-------------|----------|
-| `address_updated` | Location set or changed | googlePlacesId, formattedAddress, address, coordinates |
-| `address_cleared` | Location removed | boolean (true) |
-| `address_failed` | Location operation failed | error message, googlePlacesId (if applicable) |
-
-### Example: Update Custom UI
-
-```javascript
-// Update your own UI when address changes
-window.addEventListener('lce:actions.address_updated', (event) => {
-  const { formattedAddress } = event.detail.data;
-  document.querySelector('.delivery-location').textContent = formattedAddress;
-});
-
-// Handle address being cleared
-window.addEventListener('lce:actions.address_cleared', () => {
-  document.querySelector('.delivery-location').textContent = 'Enter your address';
-});
-```
-
----
-
-## Clear Address Behavior
-
-When an address is cleared (either by the customer or programmatically), several things happen:
-
-1. **Cart is reset** - Items are removed because pricing and availability are location-specific
-2. **Local storage is cleared** - The saved address is removed
-3. **Product displays update** - Products show "Enter address" prompts again
-
-This ensures customers never see stale pricing or unavailable items.
-
----
-
-## Use Cases
-
-### Pre-fill for Logged-in Customers
-
-```javascript
-// When user logs in, set their saved address
-if (user.savedAddress) {
-  await window.elements.actions.address.setAddressManually(
-    {
-      one: user.savedAddress.street,
-      city: user.savedAddress.city,
-      state: user.savedAddress.state,
-      zip: user.savedAddress.zip
-    },
-    {
-      lat: user.savedAddress.latitude,
-      long: user.savedAddress.longitude
-    }
-  );
-}
-```
-
-### Custom Address Form
-
-```javascript
-// Connect your own address form to the SDK
-document.querySelector('#address-form').addEventListener('submit', async (e) => {
-  e.preventDefault();
-  const formData = new FormData(e.target);
-
-  // Use your geocoding service to get coordinates
-  const coords = await geocode(formData.get('address'));
-
-  await window.elements.actions.address.setAddressManually(
-    {
-      one: formData.get('street'),
-      city: formData.get('city'),
-      state: formData.get('state'),
-      zip: formData.get('zip')
-    },
-    coords
-  );
-});
-```
-
----
-
-## Customization
-
-Style the address component through theme configuration.
-
-```javascript
-const client = await Elements('YOUR_API_KEY', {
-  customTheme: {
-    address: {
-      // Address-specific theme options
-    }
-  }
-});
-```
-
-See [theming.md](./theming.md) for available address theme options.
-
----
-
-## See Also
-
-- [Product](./product.md) - The product element (includes embedded address)
-- [Actions Reference](./actions.md) - All available actions
-- [Events Reference](./events.md) - All available events
-- [Theming Guide](./theming.md) - Customization options

package/docs/browser-support.md

@@ -1,279 +0,0 @@
-# Browser Support
-
-The LiquidCommerce Elements SDK supports all modern browsers from 2018 onward.
-
-## Minimum Supported Versions
-
-| Browser | Minimum Version | Released |
-|---------|----------------|----------|
-| Chrome | 66+ | April 2018 |
-| Firefox | 60+ | May 2018 |
-| Safari | 12+ | September 2018 |
-| Edge | 79+ (Chromium) | January 2020 |
-| Samsung Internet | 7.2+ | June 2018 |
-
-## How We Achieve Compatibility
-
-### Polyfills
-
-The SDK includes polyfills for the following DOM methods to ensure compatibility with older browsers:
-
-- `Element.prototype.replaceChildren` - Replace all children of an element
-- `Element.prototype.prepend` - Insert nodes before first child
-- `Element.prototype.remove` - Remove element from DOM
-- `Element.prototype.replaceWith` - Replace element with other nodes
-- `Element.prototype.before` - Insert nodes before element
-- `Element.prototype.after` - Insert nodes after element
-- `Object.fromEntries` - Create object from key-value pairs
-
-**Implementation:** `src/utils/dom-polyfills.ts`
-
-### Transpilation
-
-The SDK is transpiled to ES2018 via Rollup and Babel, ensuring:
-- Modern syntax compatibility
-- Promise/async-await support
-- Arrow functions and spread operators
-- Template literals and destructuring
-
-**Build target:** `es2018` (configured in `rollup.config.mjs`)
-
-## Testing Recommendations
-
-### Required Testing
-
-Test your integration on:
-- ✅ Chrome (latest stable)
-- ✅ Firefox (latest stable)
-- ✅ Safari (latest stable)
-- ✅ Mobile Safari (iOS 12+)
-- ✅ Chrome for Android
-
-### Optional Testing
-
-For broader coverage:
-- Samsung Internet (Android)
-- Edge (Chromium)
-
-## Mobile Support
-
-The SDK is fully responsive and optimized for mobile devices:
-- Touch-optimized UI components
-- Viewport-aware layouts
-- Mobile payment methods (Apple Pay, Google Pay)
-- Native mobile browser support
-
-## Progressive Web Apps (PWA)
-
-The SDK works seamlessly in PWAs:
-- Service Worker compatible
-- Offline state handling
-- LocalStorage for cart persistence
-- Mobile-first design
-
-## Known Limitations
-
-### Internet Explorer
-
-**Not supported.** Internet Explorer 11 and below are not compatible due to:
-- Lack of ES6+ support
-- Missing modern DOM APIs
-- Security vulnerabilities
-
-**Recommendation:** Show upgrade prompt for IE users.
-
-### Safari < 12
-
-Safari versions before 12 have limited support:
-- Some polyfills may not work
-- Payment features may be restricted
-- Consider showing upgrade prompt
-
-## Feature Detection
-
-The SDK automatically detects browser capabilities:
-
-```javascript
-// Automatic feature detection
-if ('IntersectionObserver' in window) {
-  // Use lazy loading
-} else {
-  // Fallback: load immediately
-}
-
-if ('localStorage' in window) {
-  // Persist cart data
-} else {
-  // Use session-only cart
-}
-```
-
-## Browser-Specific Notes
-
-### Chrome
-
-- ✅ Full feature support
-- ✅ Optimal performance
-- ✅ Payment Request API
-
-### Firefox
-
-- ✅ Full feature support
-- ⚠️ Slightly different rendering
-- ✅ All payment methods
-
-### Safari
-
-- ✅ Full feature support
-- ⚠️ Stricter CORS policies
-- ✅ Apple Pay integration
-- ⚠️ LocalStorage limits (5MB)
-
-### Edge (Chromium)
-
-- ✅ Full feature support
-- ✅ Same as Chrome (Chromium-based)
-
-### Samsung Internet
-
-- ✅ Full feature support
-- ✅ Android optimization
-- ⚠️ Custom payment flows
-
-## Detailed Version Support by Year
-
-## 2018
-
-### Chrome
-- Chrome 64, 65, 66, 67, 68, 69, 70, 71
-
-### Safari
-- Safari 11.1, 12
-
-### Firefox
-- Firefox 58, 59, 60, 61, 62, 63, 64
-
-### Samsung Internet
-- Samsung Internet 7.2, 7.4, 8.2
-
-### Edge
-- Not supported (Edge Legacy only)
-
-## 2019
-
-### Chrome
-- Chrome 72, 73, 74, 75, 76, 77, 78, 79
-
-### Safari
-- Safari 12.1, 13
-
-### Firefox
-- Firefox 65, 66, 67, 68, 69, 70, 71
-
-### Samsung Internet
-- Samsung Internet 9.0, 9.2, 10.1
-
-### Edge
-- Not supported (Edge Legacy only)
-
-## 2020
-
-### Chrome
-- Chrome 80, 81, 83, 84, 85, 86, 87
-
-### Safari
-- Safari 13.1, 14
-
-### Firefox
-- Firefox 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84
-
-### Samsung Internet
-- Samsung Internet 11.1, 11.2, 12.0
-
-### Edge
-- Edge 79, 80, 81, 83, 84, 85, 86, 87 (Chromium-based starts)
-
-## 2021
-
-### Chrome
-- Chrome 88, 89, 90, 91, 92, 93, 94, 95, 96
-
-### Safari
-- Safari 14.1, 15
-
-### Firefox
-- Firefox 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95
-
-### Samsung Internet
-- Samsung Internet 13.0, 13.2, 14.0, 14.2
-
-### Edge
-- Edge 88, 89, 90, 91, 92, 93, 94, 95, 96
-
-## 2022
-
-### Chrome
-- Chrome 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108
-
-### Safari
-- Safari 15.4, 16
-
-### Firefox
-- Firefox 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108
-
-### Samsung Internet
-- Samsung Internet 15.0, 16.0, 17.0, 18.0
-
-### Edge
-- Edge 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108
-
-## 2023
-
-### Chrome
-- Chrome 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120
-
-### Safari
-- Safari 16.4, 17
-
-### Firefox
-- Firefox 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121
-
-### Samsung Internet
-- Samsung Internet 19.0, 20.0, 21.0, 22.0
-
-### Edge
-- Edge 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120
-
-## 2024
-
-### Chrome
-- Chrome 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132
-
-### Safari
-- Safari 17.4, 18, 18.2
-
-### Firefox
-- Firefox 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133
-
-### Samsung Internet
-- Samsung Internet 23.0, 24.0, 25.0, 26.0
-
-### Edge
-- Edge 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131
-
-## 2025
-
-### Chrome
-- Chrome 133, 134
-
-### Safari
-- Safari 19 (expected)
-
-### Firefox
-- Firefox 134, 135
-
-### Samsung Internet
-- Samsung Internet 27.0 (expected)
-
-### Edge
-- Edge 132, 133