@meshmakers/octo-meshboard 3.4.530 → 3.4.550

package/README.md

@@ -72,6 +72,36 @@ To set a Well-Known Name for a MeshBoard:
 
 The Well-Known Name should be lowercase with hyphens, similar to URL slugs.
 
+### URL Sync on Board Switch (`meshBoardSyncUrl`)
+
+After a post-init board switch (e.g. via the manager dialog), the view syncs the
+loaded board's rtId into the URL:
+
+- If the active route has an `:rtId` param, the last URL segment is replaced —
+  always enabled, no configuration needed.
+- If the route has **no** `:rtId` param, appending the rtId is **opt-in** via
+  the `meshBoardSyncUrl: true` route data flag. Only set it when a matching
+  `<path>/:rtId` sibling route exists:
+
+```typescript
+{
+  path: "meshboards",
+  loadComponent: () =>
+    import('@meshmakers/octo-meshboard').then(m => m.MeshBoardViewComponent),
+  data: { meshBoardSyncUrl: true }
+},
+{
+  path: "meshboards/:rtId",
+  loadComponent: () =>
+    import('@meshmakers/octo-meshboard').then(m => m.MeshBoardViewComponent)
+}
+```
+
+Without the flag, embedded boards (e.g. readonly `meshBoardWellKnownName`
+routes) never rewrite the URL. Appending an rtId to a route without an
+`:rtId` variant would fall through to the app's `'**'` wildcard route (bouncing
+the user back to home) or fail with a `NavigationError` (AB#4457).
+
 ## Architecture
 
 ```

package/fesm2022/meshmakers-octo-meshboard.mjs

@@ -30766,6 +30766,31 @@ function placeWidgetsForTier(widgets, tier, configuredColumns) {
     }));
 }
 
+/**
+ * Returns the URL to navigate to after a board load/switch, or `null` when the
+ * URL must not be rewritten.
+ *
+ * - Route has an `:rtId` param → the last path segment is replaced.
+ * - `meshBoardSyncUrl: true` route data → the rtId is appended (the host app
+ *   guarantees a matching `<path>/:rtId` sibling route).
+ * - Otherwise → `null` (embedded boards never rewrite the URL).
+ *
+ * Query parameters are preserved in all cases.
+ */
+function buildUrlWithRtId(input) {
+    const { currentUrl, rtId, hasRtIdParam, syncUrlOptIn } = input;
+    const [pathPart, queryPart] = currentUrl.split('?');
+    const querySuffix = queryPart ? '?' + queryPart : '';
+    if (hasRtIdParam) {
+        const lastSlashIndex = pathPart.lastIndexOf('/');
+        return pathPart.substring(0, lastSlashIndex + 1) + rtId + querySuffix;
+    }
+    if (syncUrlOptIn) {
+        return `${pathPart}/${rtId}${querySuffix}`;
+    }
+    return null;
+}
+
 /**
  * Component for editing MeshBoard variables.
  * Allows adding, editing, and removing static variables with type-specific input controls.
@@ -32149,24 +32174,23 @@ class MeshBoardViewComponent {
         }
     }
     /**
-     * Updates the URL to include the current MeshBoard rtId.
-     * Preserves existing query parameters.
+     * Updates the URL to include the current MeshBoard rtId, preserving query
+     * parameters. Only rewrites the URL when the route can represent the rtId:
+     * the route has an `:rtId` param, or the host app opted in with the
+     * `meshBoardSyncUrl: true` route data flag (which requires a matching
+     * `<path>/:rtId` sibling route). Embedded boards without either stay on
+     * their URL — appending would fall through to the app's `'**'` wildcard or
+     * fail with a NavigationError (AB#4457).
      */
     updateUrlWithRtId(rtId) {
-        const currentUrl = this.router.url;
-        const hasRtIdParam = this.route.snapshot.paramMap.has('rtId');
-        // Split off query string to preserve it
-        const [pathPart, queryPart] = currentUrl.split('?');
-        const querySuffix = queryPart ? '?' + queryPart : '';
-        if (hasRtIdParam) {
-            // Replace the last URL segment (the old rtId) with the new one
-            const lastSlashIndex = pathPart.lastIndexOf('/');
-            const newPath = pathPart.substring(0, lastSlashIndex + 1) + rtId;
-            this.router.navigateByUrl(newPath + querySuffix, { replaceUrl: true });
-        }
-        else {
-            // Append the rtId to the current URL
-            this.router.navigateByUrl(`${pathPart}/${rtId}${querySuffix}`, { replaceUrl: true });
+        const targetUrl = buildUrlWithRtId({
+            currentUrl: this.router.url,
+            rtId,
+            hasRtIdParam: this.route.snapshot.paramMap.has('rtId'),
+            syncUrlOptIn: this.route.snapshot.data['meshBoardSyncUrl'] === true
+        });
+        if (targetUrl !== null) {
+            this.router.navigateByUrl(targetUrl, { replaceUrl: true });
         }
     }
     async ngOnInit() {