@mapvx/web-components-ssr 1.6.0 → 1.6.1

package/README.md

@@ -1051,6 +1051,31 @@ function App() {
 
 ### Common Issues
 
+#### `SyntaxError: Unexpected token 'export'`
+
+**Problem**: The bundle is loaded as a classic script. Since `1.3.0` `main.js` is an ES module
+that lazy-loads sibling `chunk-*.js` files, so a plain `<script src="…/main.js">` fails to parse.
+Nothing on the page runs, `customElements.define('mapvx-website', …)` is never reached, and the
+`<mapvx-website>` element stays empty — no list, no map, and no other error in the console.
+
+**Solution**: add `type="module"` to the script tag (this replaces the old `defer`, which modules
+apply on their own):
+
+```html
+<script
+  type="module"
+  src="https://unpkg.com/@mapvx/web-components-ssr@1.6.0/dist/browser/main.js"
+></script>
+<link
+  rel="stylesheet"
+  href="https://unpkg.com/@mapvx/web-components-ssr@1.6.0/dist/browser/styles.css"
+/>
+```
+
+When self-hosting the bundle instead of using a CDN, copy every `.js` file out of
+`dist/browser` keeping the `chunk-*.js` names: the relative `import()` calls in `main.js` resolve
+against its own URL.
+
 #### `SyntaxError: Unexpected token '<'` in Angular
 
 **Problem**: Angular returns HTML instead of JavaScript files from `node_modules`.
@@ -1075,7 +1100,8 @@ function App() {
 
 - Verify file paths are correct
 - Check browser console for errors
-- Ensure `defer` attribute is used for script tags
+- Ensure the script tag carries `type="module"` (see the `Unexpected token 'export'` entry above)
+- Ensure the `chunk-*.js` files sit next to `main.js` and are reachable (404s in the network tab)
 
 ## 🏠 Homepage