@liquidcommerce/elements-sdk 2.6.0-beta.96 → 2.6.0-beta.97

package/README.md

@@ -58,10 +58,14 @@ npm install @liquidcommerce/elements-sdk
 ```javascript
 import { Elements } from '@liquidcommerce/elements-sdk';
 
+// Elements() resolves to `null` if initialization fails — it never throws.
 const client = await Elements('YOUR_API_KEY', { env: 'production' });
-await client.injectProductElement([
-  { containerId: 'product', identifier: '00619947000020' }
-]);
+
+if (client) {
+  await client.injectProductElement([
+    { containerId: 'product', identifier: '00619947000020' }
+  ]);
+}
 ```
 
 ## Core Concepts (Short)
@@ -83,8 +87,10 @@ await client.injectProductElement([
 ## Key Methods (High Level)
 
 - `injectProductElement`, `injectCartElement`, `injectCheckoutElement`, `injectAddressElement`
+- `injectProductList`, `injectProductListFilters`, `injectProductListSearch`
 - `ui.cartButton`, `ui.floatingCartButton`, `ui.cartSubtotal`, `ui.cartItemsCount`
 - `actions.product`, `actions.cart`, `actions.checkout`, `actions.address`
+- `getInjectedComponents`, `destroy`
 
 ```javascript
 // Example: add a product and open cart
@@ -103,7 +109,7 @@ window.addEventListener('lce:actions.product_loaded', (event) => {
 });
 
 window.addEventListener('lce:actions.checkout_submit_completed', (event) => {
-  console.log('Order:', event.detail.data.orderId);
+  console.log('Order:', event.detail.data.orderNumber);
 });
 ```
 
@@ -140,10 +146,20 @@ Works with any framework. See:
 - [Start Here](./docs/v1/README.md)
 - [Getting Started](./docs/v1/getting-started/installation.md)
 - [Guides](./docs/v1/guides/)
+- [Accessibility](./docs/v1/guides/accessibility.md)
 - [API Reference](./docs/v1/api/)
 - [Examples](./docs/v1/examples/)
 - [Reference](./docs/v1/reference/)
 
+## Accessibility
+
+Elements target WCAG 2.1 AA out of the box: single-tab-stop keyboard groups with arrow-key
+navigation, managed focus for every overlay, screen-reader announcements for content that changes
+without navigation, and a runtime guard that corrects theme colours which fail contrast.
+
+See the [Accessibility Guide](./docs/v1/guides/accessibility.md) for the keyboard map, the list of
+announcements, and what your page is responsible for.
+
 ## Browser Support
 
 Chrome 66+, Firefox 60+, Safari 12+, Edge 79+.