@mohamedatia/fly-design-system 2.14.0 → 2.15.0

package/fesm2022/mohamedatia-fly-design-system.mjs

@@ -113,6 +113,17 @@ const FLYOS_LAUNCH_EVENT = 'flyos:launch';
  * Subsequent re-launches into the already-mounted remote arrive via the event.
  */
 const FlyosPendingLaunchesGlobalKey = '__FLYOS_PENDING_LAUNCHES__';
+/** Name of the window CustomEvent a remote dispatches when its route changes. */
+const FLYOS_REMOTE_ROUTE_EVENT = 'flyos:remote-route';
+/**
+ * `globalThis` flag set by the shell when it owns the address bar + history for
+ * ALL windows (os-core AND remotes) via `ShellHistoryService`. When set, a
+ * remote's `FlyRemoteRouter` defers history to the shell (dispatching
+ * {@link FLYOS_REMOTE_ROUTE_EVENT} instead of calling `history.pushState`) and
+ * stops handling its own `popstate` (the shell replays routes via
+ * {@link FLYOS_LAUNCH_EVENT}). Absent ⇒ legacy self-managed behaviour.
+ */
+const FlyosShellOwnsHistoryGlobalKey = '__FLYOS_SHELL_OWNS_HISTORY__';
 /**
  * Per-window injection token carrying the active <see cref="WindowHelpHint"/>
  * as a writable signal. The shell creates one writable signal per window
@@ -798,6 +809,17 @@ class FlyRemoteRouter {
     isEmbedded = this.windowData != null
         || (typeof globalThis !== 'undefined'
             && globalThis.__FLYOS_SHELL__ === true);
+    /**
+     * True when a new shell owns the browser address bar + history for every
+     * window (it set {@link FlyosShellOwnsHistoryGlobalKey}). In that mode this
+     * router defers history to the shell: it dispatches {@link FLYOS_REMOTE_ROUTE_EVENT}
+     * instead of `pushState`, and does not handle its own `popstate` (the shell
+     * replays routes via `FLYOS_LAUNCH_EVENT`). Absent ⇒ legacy self-managed mode.
+     */
+    get shellOwnsHistory() {
+        return (typeof globalThis !== 'undefined' &&
+            globalThis[FlyosShellOwnsHistoryGlobalKey] === true);
+    }
     _url = signal('/', ...(ngDevMode ? [{ debugName: "_url" }] : /* istanbul ignore next */ []));
     /**
      * Current logical URL of the remote — `/signals/abc` etc.
@@ -868,20 +890,26 @@ class FlyRemoteRouter {
                 const rawPath = window.location.pathname || '/';
                 const initialUrl = this._resolveEmbeddedInitialUrl(rawPath);
                 this._url.set(initialUrl);
-                // Listen for browser back/forward so segments() stays in sync with
-                // history entries pushed by navigate() / navigateByUrl().
-                const onPopState = (event) => {
-                    const state = event.state;
-                    // Prefer the URL we stashed in the history state; fall back to pathname.
-                    const url = state?.flyRemoteUrl ?? window.location.pathname ?? '/';
-                    this._url.set(url.startsWith('/') ? url : '/' + url);
-                };
-                window.addEventListener('popstate', onPopState);
-                // Defensive cleanup — the service is providedIn: 'root' so this fires
-                // only when the whole Angular app is destroyed, but it keeps things tidy.
-                this.destroyRef.onDestroy(() => {
-                    window.removeEventListener('popstate', onPopState);
-                });
+                // When the shell owns history it replays our route on Back/Forward via
+                // FLYOS_LAUNCH_EVENT (the remote root re-applies it), so we must NOT also
+                // handle popstate — the shell's entries carry no `flyRemoteUrl` and we'd
+                // clobber `_url` with the shell path. Only self-manage under a legacy shell.
+                if (!this.shellOwnsHistory) {
+                    // Listen for browser back/forward so segments() stays in sync with
+                    // history entries pushed by navigate() / navigateByUrl().
+                    const onPopState = (event) => {
+                        const state = event.state;
+                        // Prefer the URL we stashed in the history state; fall back to pathname.
+                        const url = state?.flyRemoteUrl ?? window.location.pathname ?? '/';
+                        this._url.set(url.startsWith('/') ? url : '/' + url);
+                    };
+                    window.addEventListener('popstate', onPopState);
+                    // Defensive cleanup — the service is providedIn: 'root' so this fires
+                    // only when the whole Angular app is destroyed, but it keeps things tidy.
+                    this.destroyRef.onDestroy(() => {
+                        window.removeEventListener('popstate', onPopState);
+                    });
+                }
             }
         }
     }
@@ -972,10 +1000,28 @@ class FlyRemoteRouter {
      * the query string.
      */
     _pushEmbedded(url) {
+        this._url.set(url);
+        if (this.shellOwnsHistory && typeof window !== 'undefined') {
+            // Single-writer mode: hand the route to the shell, which owns the address
+            // bar + browser history for every window. The shell mirrors it to the
+            // canonical `…/desktop?app=&route=` form and pushes one history entry.
+            const appId = this.windowData?.appId;
+            if (appId) {
+                const detail = {
+                    appId,
+                    windowId: this.windowData?.id ?? null,
+                    url,
+                };
+                window.dispatchEvent(new CustomEvent(FLYOS_REMOTE_ROUTE_EVENT, { detail }));
+                return;
+            }
+            // No appId reachable (WINDOW_DATA split across bundles) — fall through to
+            // the legacy local history entry so Back/Forward still update segments().
+        }
+        // Legacy / fallback: self-managed history entry (older shell, or no appId).
         if (typeof history !== 'undefined') {
             history.pushState({ flyRemoteUrl: url }, '', this._buildEmbeddedHistoryUrl(url));
         }
-        this._url.set(url);
     }
     /**
      * Build the browser-address-bar URL for an embedded navigation: the shell's
@@ -6498,5 +6544,5 @@ const AUDIENCE_ERROR_CODES = {
  * Generated bundle index. Do not edit.
  */
 
-export { AGENT_DRAG_MIME, AGENT_PAYLOAD_VERSION, APP_LOOKUP, AUDIENCE_ERROR_CODES, AUDIENCE_LIMITS, AUDIENCE_PRESETS, AUDIENCE_TERM_KINDS, AgentActionBus, AgentActionUnsupportedDispatchError, AgentCommandRegistry, AgentDropRegistry, AgentFlightAnimator, AgentLookupRegistry, AgentPayloadOversizeError, AudienceBuilderComponent, AuthService, ContextMenuComponent, DEFAULT_AGENT_PAYLOAD_LIMITS, DEFAULT_FLY_THEME_MODE, DS_BASELINE_LOCALES, DialogResult, ENTITY_LINK_LAUNCHER, EntityLookupComponent, FLYOS_LAUNCH_EVENT, FLY_LOCALE_CATALOG, FLY_REMOTE_BASE_PATH, FLY_REMOTE_CONTEXT_EVENT, FLY_REMOTE_CONTEXT_STORE_KEY, FLY_REMOTE_ROUTES, FLY_THEME_MODE_IDS, FLY_WINDOW_HELP_HINT_EVENT, FlyAgentDraggableDirective, FlyBlockUiComponent, FlyFileUploadComponent, FlyImageUploadComponent, FlyMarkdownEditorComponent, FlyRemoteContextService, FlyRemoteRouter, FlyRemoteRouterOutletComponent, FlySecureSrcDirective, FlyThemeService, FlyWindowHelpService, FlyosPendingLaunchesGlobalKey, I18nService, LAUNCH_CONTEXT, MARKDOWN_TOOLBAR_PRESETS, MessageBoxButtons, MessageBoxComponent, MessageBoxIcon, MessageBoxService, MockAuthService, RTL_LOCALE_SET, SHARE_ORG_CHART_SYSTEM_KEY_APPS, SHARE_ORG_CHART_SYSTEM_KEY_DEFAULT, SHARE_PANEL_DEFAULT_FILE_LEVELS, SUPPORTED_AGENT_PAYLOAD_VERSIONS, SharePanelComponent, SourceAppResolver, StandaloneWindowManagerService, TranslatePipe, WINDOW_DATA, WINDOW_HELP_HINT, WindowManagerService, findLocaleByDialect, findLocaleByPrefix, isRtlLocale, isRtlLocaleEntry, loadRemoteStyles, matchFlyRoutePattern, normalizeFlyTheme, trimAgentPayload, trimAgentString, unloadRemoteStyles, utf8ByteLength, validateAgentPayload };
+export { AGENT_DRAG_MIME, AGENT_PAYLOAD_VERSION, APP_LOOKUP, AUDIENCE_ERROR_CODES, AUDIENCE_LIMITS, AUDIENCE_PRESETS, AUDIENCE_TERM_KINDS, AgentActionBus, AgentActionUnsupportedDispatchError, AgentCommandRegistry, AgentDropRegistry, AgentFlightAnimator, AgentLookupRegistry, AgentPayloadOversizeError, AudienceBuilderComponent, AuthService, ContextMenuComponent, DEFAULT_AGENT_PAYLOAD_LIMITS, DEFAULT_FLY_THEME_MODE, DS_BASELINE_LOCALES, DialogResult, ENTITY_LINK_LAUNCHER, EntityLookupComponent, FLYOS_LAUNCH_EVENT, FLYOS_REMOTE_ROUTE_EVENT, FLY_LOCALE_CATALOG, FLY_REMOTE_BASE_PATH, FLY_REMOTE_CONTEXT_EVENT, FLY_REMOTE_CONTEXT_STORE_KEY, FLY_REMOTE_ROUTES, FLY_THEME_MODE_IDS, FLY_WINDOW_HELP_HINT_EVENT, FlyAgentDraggableDirective, FlyBlockUiComponent, FlyFileUploadComponent, FlyImageUploadComponent, FlyMarkdownEditorComponent, FlyRemoteContextService, FlyRemoteRouter, FlyRemoteRouterOutletComponent, FlySecureSrcDirective, FlyThemeService, FlyWindowHelpService, FlyosPendingLaunchesGlobalKey, FlyosShellOwnsHistoryGlobalKey, I18nService, LAUNCH_CONTEXT, MARKDOWN_TOOLBAR_PRESETS, MessageBoxButtons, MessageBoxComponent, MessageBoxIcon, MessageBoxService, MockAuthService, RTL_LOCALE_SET, SHARE_ORG_CHART_SYSTEM_KEY_APPS, SHARE_ORG_CHART_SYSTEM_KEY_DEFAULT, SHARE_PANEL_DEFAULT_FILE_LEVELS, SUPPORTED_AGENT_PAYLOAD_VERSIONS, SharePanelComponent, SourceAppResolver, StandaloneWindowManagerService, TranslatePipe, WINDOW_DATA, WINDOW_HELP_HINT, WindowManagerService, findLocaleByDialect, findLocaleByPrefix, isRtlLocale, isRtlLocaleEntry, loadRemoteStyles, matchFlyRoutePattern, normalizeFlyTheme, trimAgentPayload, trimAgentString, unloadRemoteStyles, utf8ByteLength, validateAgentPayload };
 //# sourceMappingURL=mohamedatia-fly-design-system.mjs.map