@lockerverse/react 0.2.228 → 0.2.230

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,23 @@
1
+ Bundled license information:
2
+
3
+ scheduler/cjs/scheduler.production.js:
4
+ /**
5
+ * @license React
6
+ * scheduler.production.js
7
+ *
8
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
9
+ *
10
+ * This source code is licensed under the MIT license found in the
11
+ * LICENSE file in the root directory of this source tree.
12
+ */
13
+
14
+ react-dom/cjs/react-dom-client.production.js:
15
+ /**
16
+ * @license React
17
+ * react-dom-client.production.js
18
+ *
19
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
20
+ *
21
+ * This source code is licensed under the MIT license found in the
22
+ * LICENSE file in the root directory of this source tree.
23
+ */
@@ -1,6 +1,6 @@
1
1
  # Lockerverse auctions guide
2
2
 
3
- Package: @lockerverse/react@0.2.228
3
+ Package: @lockerverse/react@0.2.230
4
4
 
5
5
  Generated from this release's maintained documentation. Do not edit this copy.
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Lockerverse bookings guide
2
2
 
3
- Package: @lockerverse/react@0.2.228
3
+ Package: @lockerverse/react@0.2.230
4
4
 
5
5
  Generated from this release's maintained documentation. Do not edit this copy.
6
6
 
@@ -0,0 +1,125 @@
1
+ # Lockerverse browser-embed guide
2
+
3
+ Package: @lockerverse/react@0.2.230
4
+
5
+ Generated from this release's maintained documentation. Do not edit this copy.
6
+
7
+ Read [the shared integration guide](integration.md) first.
8
+
9
+ ## Browser embed
10
+
11
+ The browser embed is an optional integration for sites that cannot use the React
12
+ SDK directly. It bundles React and the existing auction interface. The host does
13
+ not need to install React, configure a build tool, or provide an iframe.
14
+
15
+ Use the React SDK when the host already uses React and needs its full component
16
+ API. The embed has a smaller configuration surface. It does not provide template
17
+ slots, custom component renderers, or server-rendered auction content. It is a
18
+ fallback for frameworks without a dedicated Lockerverse integration, not a
19
+ promise of compatibility with every CMS or site security policy.
20
+
21
+ ## Add an auction
22
+
23
+ This snippet uses `0.2.230`. Keep the version pinned so a package release does not change the
24
+ host's integration without a review.
25
+
26
+ ```html
27
+ <script
28
+ type="module"
29
+ src="https://unpkg.com/@lockerverse/react@0.2.230/dist/embed/lockerverse.js"
30
+ ></script>
31
+
32
+ <lockerverse-auctions
33
+ community="auburn"
34
+ auction="auburn-vs-georgia-memorabilia-october-2026"
35
+ theme="light"
36
+ ></lockerverse-auctions>
37
+ ```
38
+
39
+ On first load, the element displays a placeholder while it loads the auction.
40
+ It starts the public catalog request alongside the interface download.
41
+ The host can provide its own placeholder inside the element for the time
42
+ before the script executes.
43
+
44
+ Load the script once per page. No separate stylesheet is required. Remove the
45
+ `auction` attribute to show all public auctions for the community. No API secret
46
+ or private credential belongs in the markup.
47
+
48
+ ## Settings
49
+
50
+ | Attribute | Default | Purpose |
51
+ | --- | --- | --- |
52
+ | `community` | Required | Public community slug, such as `auburn`. |
53
+ | `auction` | Not set | Public auction slug. Omit it to start with the community's auctions. |
54
+ | `theme` | `light` | `light` or `dark`. Can change while the element is mounted. |
55
+ | `accent` | SDK default | Optional CSS color for the supported accent treatment. Can change while mounted. |
56
+ | `instance` | `main` | Stable name for this embed's URL parameters. Give each embed on a page a different name. |
57
+ | `nonce` | Not set | Optional server-generated CSP nonce, copied to the embedded stylesheet. Set it before inserting the element. |
58
+ | `environment` | `production` | `production` uses `https://portal.lockerverse.com/api`; `development` uses `https://portal-dev.lockerverse.com/api`. |
59
+
60
+ Treat `community`, `auction`, `environment`, and `instance` as fixed identity
61
+ settings while the element is mounted. To change them, replace it with a new element
62
+ with the new attributes. Moving the same element preserves its original state. Do not replace or remove the element
63
+ while a bid or payment is unresolved. Theme and accent updates do not require a
64
+ remount.
65
+
66
+ The interface uses an open shadow root to keep its styles separate from the host
67
+ page. The gallery overlay stays inside that root. Use the supported attributes
68
+ for appearance changes; internal DOM structure and CSS selectors are not a
69
+ public customization API. Give the element the width needed by the page layout.
70
+ Its content determines its height.
71
+
72
+ ## Links and host routing
73
+
74
+ The embed uses page query parameters for auction and item links:
75
+
76
+ - `lv-main-auction` selects an auction.
77
+ - `lv-main-item` selects an item.
78
+
79
+ A custom `instance="vault"` changes these keys to `lv-vault-auction` and
80
+ `lv-vault-item`. Keep instance names stable so shared links continue to work.
81
+ The host must preserve these parameters and serve the page when they are
82
+ present. Confirm direct item links, reload, Back, Forward, and opening links in a
83
+ new tab in the host's router. Other host query parameters remain separate.
84
+
85
+ For Vue or another framework, the host can insert the element as ordinary DOM.
86
+ If its template compiler treats unknown tags as application components,
87
+ configure it to treat `lockerverse-auctions` as a custom element. The browser
88
+ script owns the element's contents; the host owns the surrounding page.
89
+
90
+ ## Host requirements
91
+
92
+ The CMS must permit the script and custom element. The browser must support
93
+ JavaScript modules, custom elements, and shadow DOM. An editor that removes
94
+ scripts or rewrites the element needs a developer-controlled integration area.
95
+
96
+ If the site has a Content Security Policy, its team must permit the script CDN,
97
+ the selected Lockerverse API, auction media sources, and the Stripe resources
98
+ needed by checkout. The embed inserts a stylesheet into its shadow root. If
99
+ inline styles require a nonce, put the server-generated nonce on the element
100
+ and include that same nonce in the response policy. React also sets inline style
101
+ properties for layout and appearance; check those against the host policy.
102
+ Check the actual requests and the site's policy; do not
103
+ replace its policy with a broad allow-all rule. Payment methods can have their
104
+ own domain requirements. Confirm checkout on the final host domain before
105
+ announcing support for those methods.
106
+
107
+ This is a browser-rendered integration. The host still owns page titles,
108
+ metadata, accessibility of surrounding content, and search indexing. Do not use
109
+ it to replace a working server-rendered React integration solely to reduce the
110
+ host's setup code.
111
+
112
+ ## Check the integration
113
+
114
+ After the script version is published, check the snippet on the target host:
115
+
116
+ 1. Confirm the script and its assets load without policy or network errors.
117
+ 2. Confirm the expected community, auction, item images, and prices appear.
118
+ 3. Check mobile layout, item links, gallery controls, and browser navigation.
119
+ 4. Confirm light/dark appearance and any accent setting fit the host page.
120
+ 5. Inspect checkout loading and recovery behavior without submitting a live bid
121
+ or payment for an integration check.
122
+
123
+ The embed reuses the SDK's auction behavior. Shipping React inside the bundle
124
+ removes the host's React setup requirement; it does not remove network,
125
+ security-policy, browser, or payment-provider constraints.
package/guides/events.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Lockerverse events guide
2
2
 
3
- Package: @lockerverse/react@0.2.228
3
+ Package: @lockerverse/react@0.2.230
4
4
 
5
5
  Generated from this release's maintained documentation. Do not edit this copy.
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Lockerverse integration guide
2
2
 
3
- Package: @lockerverse/react@0.2.228
3
+ Package: @lockerverse/react@0.2.230
4
4
 
5
5
  Generated from this release's maintained documentation. Do not edit this copy.
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Lockerverse payment-widgets guide
2
2
 
3
- Package: @lockerverse/react@0.2.228
3
+ Package: @lockerverse/react@0.2.230
4
4
 
5
5
  Generated from this release's maintained documentation. Do not edit this copy.
6
6
 
package/guides/signup.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Lockerverse signup guide
2
2
 
3
- Package: @lockerverse/react@0.2.228
3
+ Package: @lockerverse/react@0.2.230
4
4
 
5
5
  Generated from this release's maintained documentation. Do not edit this copy.
6
6
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lockerverse/react",
3
- "version": "0.2.228",
3
+ "version": "0.2.230",
4
4
  "description": "Tree-shakable React payment and signup UI for Lockerverse",
5
5
  "repository": {
6
6
  "type": "git",
@@ -146,7 +146,7 @@
146
146
  "embla-carousel-react": "8.6.0",
147
147
  "lucide-react": "0.536.0",
148
148
  "valibot": "1.4.2",
149
- "@lockerverse/sdk": "0.2.228"
149
+ "@lockerverse/sdk": "0.2.230"
150
150
  },
151
151
  "devDependencies": {
152
152
  "@size-limit/file": "13.0.3",
@@ -156,6 +156,7 @@
156
156
  "@types/react": "19.2.18",
157
157
  "@types/react-dom": "19.2.4",
158
158
  "@vitest/browser-playwright": "4.1.10",
159
+ "esbuild": "0.28.2",
159
160
  "playwright": "1.62.1",
160
161
  "prop-types": "15.8.1",
161
162
  "react": "19.2.8",
@@ -243,7 +244,7 @@
243
244
  }
244
245
  ],
245
246
  "scripts": {
246
- "build": "node ../../scripts/copy-package-instructions.mjs react && node ../../scripts/build-integration-guides.mjs && tsdown",
247
+ "build": "node ../../scripts/copy-package-instructions.mjs react && node ../../scripts/build-integration-guides.mjs && tsdown && node build-embed.mjs",
247
248
  "pack:check": "pnpm build && pnpm pack --dry-run",
248
249
  "size": "size-limit",
249
250
  "pretest": "pnpm --filter @lockerverse/sdk build",