@liquidcommerce/elements-sdk 2.2.2 → 2.4.0

package/docs/BROWSER_SUPPORT.md

@@ -0,0 +1,279 @@
+# 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