@equinor/fusion-framework-plugin-context-navigation 0.1.0 → 0.1.1

package/dist/esm/helpers/strip-query-params.js

@@ -0,0 +1,14 @@
+/**
+ * Strip all query parameters from a URL.
+ *
+ * Used on app switches to give the adapter a clean URL. The adapter's
+ * `encode()` will add back whatever params it needs (e.g. `$contextId`
+ * for query-strategy apps). On context-only changes within the same app,
+ * this function is not called — query params survive naturally.
+ *
+ * @param url - The URL to strip (mutated in-place).
+ */
+export function stripQueryParams(url) {
+    url.search = '';
+}
+//# sourceMappingURL=strip-query-params.js.map

package/dist/esm/helpers/strip-query-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-query-params.js","sourceRoot":"","sources":["../../../src/helpers/strip-query-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACvC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;AAClB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,13 @@
+// Plugin
+export { createContextNavigationPlugin } from './create-context-navigation-plugin';
+// Configurator
+export { ContextNavigationConfigurator } from './ContextNavigationConfigurator';
+// Enable helper
+export { enableContextNavigation } from './enable-context-navigation';
+// Legacy compat
+export { legacyAppNavigationFix } from './utils/legacy-app-navigation-fix';
+// Events (side-effect: augments FrameworkEventMap)
+import './events';
+// Version
+export { version } from './version';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAMnF,eAAe;AACf,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAEhF,gBAAgB;AAChB,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAWtE,gBAAgB;AAChB,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,mDAAmD;AACnD,OAAO,UAAU,CAAC;AAElB,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/esm/operators/active-app-navigation-events.js

@@ -0,0 +1,52 @@
+import { EMPTY, combineLatestWith, map, switchMap } from 'rxjs';
+/**
+ * RxJS operator factory that produces an emission each time the browser
+ * navigation state changes while a fully resolved app is present.
+ *
+ * Intent: decouple the URL guard from the mechanics of observing app readiness.
+ * The guard only needs to know "an app is active and a navigation just happened" —
+ * this operator encapsulates the four-level observable plumbing required to
+ * produce that signal:
+ *
+ * 1. **App switch** — outer `switchMap` on `app.current$`. If the portal switches
+ *    to a different app (or clears the app), inner subscriptions auto-cancel.
+ * 2. **Module + manifest resolution** — middle `switchMap` on
+ *    `currentApp.instance$.pipe(combineLatestWith(currentApp.manifest$))`.
+ *    Waits until both the app's lazy modules and its manifest have resolved.
+ *    Emits EMPTY if modules are null.
+ * 3. **Routing strategy extraction** — `manifest.build.options.contextRouting`
+ *    is projected into the downstream payload so the guard can pass it to
+ *    adapter resolution without a separate manifest lookup.
+ * 4. **Navigation event** — inner `map` on `navigation.state$`. Each state change
+ *    (push, replace, popstate) triggers a downstream emission carrying the
+ *    resolved app key, modules, and routing strategy.
+ *
+ * @param app - The app module provider (source of `current$`).
+ * @param navigation - The navigation provider (source of `state$`).
+ * @returns An observable that emits `{ appKey, appModules }` on every navigation
+ *          event while an active app with resolved modules is present.
+ */
+export function activeAppNavigationEvents(app, navigation) {
+    // Emit once per navigation event while the active app is fully resolved
+    return app.current$.pipe(
+    // Cancel inner subscriptions when the active app changes or is cleared.
+    switchMap((currentApp) => !currentApp
+        ? EMPTY
+        : currentApp.instance$
+            // Pair the app instance with its manifest; both must resolve before emitting
+            .pipe(combineLatestWith(currentApp.manifest$), 
+        // Wait for modules to resolve; bail if they're null (loading/error).
+        switchMap(([appModules, manifest]) => !appModules
+            ? EMPTY
+            : navigation.state$
+                // Each state$ emission represents a navigation event; project app identity into payload
+                .pipe(
+            // Each state$ emission means a navigation happened — project
+            // the resolved app identity into the downstream payload.
+            map(() => ({
+                appKey: currentApp.appKey,
+                appModules: appModules,
+                routingStrategy: manifest?.build?.options?.contextRouting,
+            })))))));
+}
+//# sourceMappingURL=active-app-navigation-events.js.map

package/dist/esm/operators/active-app-navigation-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-app-navigation-events.js","sourceRoot":"","sources":["../../../src/operators/active-app-navigation-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAmB,iBAAiB,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAyBjF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAsB,EACtB,UAA+B;IAE/B,wEAAwE;IACxE,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI;IACtB,wEAAwE;IACxE,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE,CACvB,CAAC,UAAU;QACT,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,UAAU,CAAC,SAAS;YAClB,6EAA6E;aAC5E,IAAI,CACH,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC;QACvC,qEAAqE;QACrE,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,CACnC,CAAC,UAAU;YACT,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,UAAU,CAAC,MAAM;gBACf,wFAAwF;iBACvF,IAAI;YACH,6DAA6D;YAC7D,yDAAyD;YACzD,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;gBACT,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,UAAU,EAAE,UAAiD;gBAC7D,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc;aAC1D,CAAC,CAAC,CACJ,CACR,CACF,CACR,CACF,CAAC;AACJ,CAAC"}

package/dist/esm/reconcile.js

@@ -0,0 +1,76 @@
+import { getCurrentURL, normalizePathFromURL, resolveAdapter, stripQueryParams } from './helpers';
+import { applyNavigation } from './apply-navigation';
+/**
+ * Reconcile a source entry: resolve an adapter and apply navigation
+ * for the given app/context combination.
+ *
+ * Handles three context states:
+ * - `undefined` — context not yet resolved, skip.
+ * - `null` — context cleared, navigate to `nullContextUrl` if configured.
+ * - `ContextItem` — active context, encode via adapter and navigate.
+ *
+ * @param entry - The reconciler source entry with app key, modules, and context state.
+ * @param deps - Shared plugin dependencies.
+ * @param options - Optional trigger context (e.g. whether this is an app switch).
+ */
+export function reconcile(entry, deps, options = {}) {
+    const { appKey, appModules, contextState, routingStrategy } = entry;
+    const { event, navigation, config, eventSource, ownNavTokens, log } = deps;
+    // Context not yet resolved, skip reconciliation and wait for context to be available
+    if (contextState === undefined) {
+        event.dispatchEvent('onContextNavigationSkipped', {
+            detail: { appKey, reason: 'no-context' },
+            source: eventSource,
+        });
+        log(`Context undefined for [${appKey}] — idle, waiting.`);
+        return;
+    }
+    // Context cleared, navigate to the configured null context URL
+    if (contextState === null && config.nullContextUrl) {
+        const currentURL = getCurrentURL(navigation, config.origin);
+        const targetPath = config.nullContextUrl({ appKey, currentURL });
+        const targetURL = new URL(targetPath, config.origin);
+        // Only navigate if the target path differs from current path
+        if (normalizePathFromURL(targetURL) !== normalizePathFromURL(currentURL)) {
+            ownNavTokens.add(normalizePathFromURL(targetURL));
+            navigation.navigate(targetURL, config.navigationOptions);
+            log(`Null context → navigated to [${targetPath}] for [${appKey}]`);
+        }
+        return;
+    }
+    const appContext = appModules.context;
+    // App context not available, skip reconciliation
+    if (!appContext) {
+        return;
+    }
+    const currentURL = getCurrentURL(navigation, config.origin);
+    // On app switch, strip all query params so nothing leaks from the
+    // previous app. The adapter will add back what it needs.
+    // This ensures a clean slate for the new app's context encoding.
+    if (options.isAppSwitch) {
+        stripQueryParams(currentURL);
+        log(`App switch detected → stripped query params for [${appKey}]`);
+    }
+    // When switching apps, always replace the history entry rather than pushing.
+    // The portal already pushed a new entry for the app navigation; adding another
+    // push here would create a double entry that traps the user when pressing Back.
+    // `config.navigationOptions.replace` only applies to in-app context changes.
+    const navOptionsOverride = options.isAppSwitch ? { replace: true } : undefined;
+    const adapter = resolveAdapter({ appKey, appContext, routingStrategy, currentURL }, config.adapters);
+    // No matching adapter found for this app, skip navigation
+    if (!adapter) {
+        event.dispatchEvent('onContextNavigationSkipped', {
+            detail: { appKey, reason: 'no-adapter' },
+            source: eventSource,
+        });
+        log(`No adapter matched for [${appKey}] — skipping.`);
+        return;
+    }
+    event.dispatchEvent('onContextNavigationAdapterResolved', {
+        detail: { appKey, adapterId: adapter.id },
+        source: eventSource,
+    });
+    log(`Resolved adapter [${adapter.id}] for [${appKey}]`);
+    applyNavigation({ appKey, appModules, adapter, context: contextState, currentURL }, deps, navOptionsOverride);
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/esm/reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../../src/reconcile.ts"],"names":[],"mappings":"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"}

package/dist/esm/sources/app-first-source.js

@@ -0,0 +1,41 @@
+import { switchMap, EMPTY, of, combineLatestWith, distinctUntilChanged } from 'rxjs';
+import { contextStateChanged } from './types';
+/**
+ * App-first source factory — app switches lead, context follows.
+ *
+ * Stream composition:
+ * ```
+ * app.current$ → combineLatest(instance$, manifest$) → combineLatestWith(context.currentContext$)
+ * ```
+ *
+ * Use this for **app-portal** where the active app determines the navigation
+ * context. Context changes are reconciled within the scope of the current app.
+ */
+export const appFirstSource = () => {
+    return ({ app, context }) => {
+        return (app.current$
+            // Track the active app; each switch abandons the previous app's streams and starts fresh
+            .pipe(switchMap((currentApp) => {
+            // No active app yet (e.g. initial load or app unmounted) — nothing to reconcile
+            if (!currentApp) {
+                return EMPTY;
+            }
+            return (currentApp.instance$
+                // Wait for both the module instance and the manifest to resolve before projecting downstream
+                .pipe(combineLatestWith(currentApp.manifest$), switchMap(([appModules, manifest]) => {
+                // App is registered but its module bundle hasn't resolved yet — skip until it's ready
+                if (!appModules) {
+                    return EMPTY;
+                }
+                return of({
+                    appModules: appModules,
+                    appKey: currentApp.appKey,
+                    routingStrategy: manifest?.build?.options?.contextRouting,
+                });
+            })));
+        }), combineLatestWith(context.currentContext$
+            // Suppress redundant reconciler runs when context identity hasn't actually changed
+            .pipe(distinctUntilChanged(contextStateChanged))), switchMap(([{ appModules, appKey, routingStrategy }, contextState]) => of({ appKey, appModules, contextState, routingStrategy }))));
+    };
+};
+//# sourceMappingURL=app-first-source.js.map

package/dist/esm/sources/app-first-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-first-source.js","sourceRoot":"","sources":["../../../src/sources/app-first-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,MAAM,CAAC;AAKrF,OAAO,EAAE,mBAAmB,EAAgC,MAAM,SAAS,CAAC;AAE5E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAA4B,EAAE;IAC1D,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE;QAC1B,OAAO,CACL,GAAG,CAAC,QAAQ;YACV,yFAAyF;aACxF,IAAI,CACH,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;YACvB,gFAAgF;YAChF,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,CACL,UAAU,CAAC,SAAS;gBAClB,6FAA6F;iBAC5F,IAAI,CACH,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC,EACvC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE;gBACnC,sFAAsF;gBACtF,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,OAAO,EAAE,CAAC;oBACR,UAAU,EAAE,UAAiD;oBAC7D,MAAM,EAAE,UAAU,CAAC,MAAM;oBACzB,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc;iBAC1D,CAAC,CAAC;YACL,CAAC,CAAC,CACH,CACJ,CAAC;QACJ,CAAC,CAAC,EACF,iBAAiB,CACf,OAAO,CAAC,eAAe;YACrB,mFAAmF;aAClF,IAAI,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC,CACnD,EACD,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,YAAY,CAAC,EAAE,EAAE,CACpE,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,CAC1D,CACF,CACJ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/sources/context-first-source.js

@@ -0,0 +1,47 @@
+import { switchMap, EMPTY, of, combineLatestWith, distinctUntilChanged } from 'rxjs';
+import { contextStateChanged } from './types';
+/**
+ * Context-first source factory — context changes lead, app follows.
+ *
+ * Stream composition:
+ * ```
+ * context.currentContext$ → combineLatestWith(app.current$ → combineLatest(instance$, manifest$))
+ * ```
+ *
+ * Use this for **context-portal** where the selected context drives all
+ * navigation. App switches are reconciled within the scope of the current
+ * context.
+ */
+export const contextFirstSource = () => {
+    return ({ app, context }) => {
+        return (context.currentContext$
+            // Context is the primary signal — downstream app state reacts to each change
+            // Deduplicate context changes and combine with the active app's instance and manifest
+            .pipe(distinctUntilChanged(contextStateChanged), combineLatestWith(app.current$
+            // Reactively pair context state with the active app's resolved instance and manifest
+            // Resolve the active app to its instance and manifest — emits nothing until both are ready
+            .pipe(switchMap((currentApp) => {
+            // No active app yet — nothing to reconcile against
+            if (!currentApp) {
+                return EMPTY;
+            }
+            return (currentApp.instance$
+                // Both instance and manifest must be resolved — manifest provides the routing strategy
+                // Combine instance and manifest into a single resolved app shape
+                .pipe(combineLatestWith(currentApp.manifest$), switchMap(([appModules, manifest]) => {
+                // App is loading or failed to initialize — defer until instance is available
+                if (!appModules) {
+                    return EMPTY;
+                }
+                return of({
+                    appModules: appModules,
+                    appKey: currentApp.appKey,
+                    routingStrategy: manifest?.build?.options?.contextRouting,
+                });
+            })));
+        }))))
+            // Flatten the combined tuple into a unified reconciler input object
+            .pipe(switchMap(([contextState, { appModules, appKey, routingStrategy }]) => of({ appKey, appModules, contextState, routingStrategy }))));
+    };
+};
+//# sourceMappingURL=context-first-source.js.map

package/dist/esm/sources/context-first-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-first-source.js","sourceRoot":"","sources":["../../../src/sources/context-first-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,MAAM,CAAC;AAKrF,OAAO,EAAE,mBAAmB,EAAgC,MAAM,SAAS,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAA4B,EAAE;IAC9D,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE;QAC1B,OAAO,CACL,OAAO,CAAC,eAAe;YACrB,6EAA6E;YAC7E,sFAAsF;aACrF,IAAI,CACH,oBAAoB,CAAC,mBAAmB,CAAC,EACzC,iBAAiB,CACf,GAAG,CAAC,QAAQ;YACV,qFAAqF;YACrF,2FAA2F;aAC1F,IAAI,CACH,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;YACvB,mDAAmD;YACnD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,CACL,UAAU,CAAC,SAAS;gBAClB,uFAAuF;gBACvF,iEAAiE;iBAChE,IAAI,CACH,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC,EACvC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE;gBACnC,6EAA6E;gBAC7E,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,OAAO,EAAE,CAAC;oBACR,UAAU,EAAE,UAAiD;oBAC7D,MAAM,EAAE,UAAU,CAAC,MAAM;oBACzB,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc;iBAC1D,CAAC,CAAC;YACL,CAAC,CAAC,CACH,CACJ,CAAC;QACJ,CAAC,CAAC,CACH,CACJ,CACF;YACD,oEAAoE;aACnE,IAAI,CACH,SAAS,CAAC,CAAC,CAAC,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,EAAE,CACpE,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,CAC1D,CACF,CACJ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/sources/index.js

@@ -0,0 +1,4 @@
+export { appFirstSource } from './app-first-source';
+export { contextFirstSource } from './context-first-source';
+export { contextStateChanged, } from './types';
+//# sourceMappingURL=index.js.map

package/dist/esm/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EACL,mBAAmB,GAMpB,MAAM,SAAS,CAAC"}

package/dist/esm/sources/types.js

@@ -0,0 +1,16 @@
+// ─── Shared Comparator ──────────────────────────────────────────────
+/**
+ * Equality comparator for `ContextState` values in `distinctUntilChanged`.
+ *
+ * Returns `true` when the two states represent the same context identity,
+ * preventing redundant reconciler emissions. Both `null` (cleared) and
+ * `undefined` (initializing) are compared by reference; active contexts
+ * are compared by `id`.
+ */
+export const contextStateChanged = (a, b) => {
+    // Both are active contexts — compare by ID
+    if (a && b)
+        return a.id === b.id;
+    return a === b;
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/sources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sources/types.ts"],"names":[],"mappings":"AA0EA,uEAAuE;AAEvE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAe,EAAE,CAAe,EAAW,EAAE;IAC/E,2CAA2C;IAC3C,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;IACjC,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC,CAAC"}

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/esm/utils/has-custom-context-generators.js

@@ -0,0 +1,14 @@
+/**
+ * Check whether an app's context provider has custom path generators registered.
+ *
+ * Returns `true` when both `extractContextIdFromPath` and
+ * `generatePathFromContext` are present, indicating the app owns its own
+ * URL shape and should be handled by the custom adapter.
+ *
+ * @param appContext - The app's context provider instance.
+ * @returns `true` if the app has custom context generators, `false` otherwise.
+ */
+export function hasCustomContextGenerators(appContext) {
+    return !!appContext.extractContextIdFromPath && !!appContext.generatePathFromContext;
+}
+//# sourceMappingURL=has-custom-context-generators.js.map

package/dist/esm/utils/has-custom-context-generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-custom-context-generators.js","sourceRoot":"","sources":["../../../src/utils/has-custom-context-generators.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAA4B;IACrE,OAAO,CAAC,CAAC,UAAU,CAAC,wBAAwB,IAAI,CAAC,CAAC,UAAU,CAAC,uBAAuB,CAAC;AACvF,CAAC"}

package/dist/esm/utils/legacy-app-navigation-fix.js

@@ -0,0 +1,45 @@
+// Import event type augmentations so the event name is recognized
+import '../events';
+const LEGACY_NAVIGATION_VERSION = 7;
+/**
+ * Register a legacy app navigation fix that resets the app's internal
+ * router when context navigation occurs and the app uses a navigation
+ * module older than v7.
+ *
+ * Apps with navigation <v7 don't respond to portal navigation events
+ * correctly. This listener detects them and calls `appNavigation.replace('/')`
+ * after each context navigation to keep the app router in sync.
+ *
+ * Call this during framework configuration (e.g. in `postInitialize`)
+ * and store the returned teardown function to clean up when needed.
+ *
+ * @param deps - The required framework module instances.
+ * @returns A teardown function that removes the listener.
+ *
+ * @example
+ * ```ts
+ * // In portal framework configuration:
+ * const teardown = legacyAppNavigationFix({ event });
+ * ```
+ */
+export function legacyAppNavigationFix(deps) {
+    const { event } = deps;
+    return event.addEventListener('onContextNavigationNavigated', (e) => {
+        // Only act when context is cleared — regular navigation doesn't need fixing
+        if (e.detail.context !== null) {
+            return;
+        }
+        const { appKey, appModules } = e.detail;
+        const appNavigation = appModules.navigation;
+        // Apps without a navigation module have no router to reset — nothing to do
+        if (!appNavigation) {
+            return;
+        }
+        // Legacy nav modules don't respond to portal context changes — force a router reset
+        if (appNavigation.version.major < LEGACY_NAVIGATION_VERSION) {
+            console.warn(`[ContextNavigation] App [${appKey}] uses navigation v${appNavigation.version.major} (< ${LEGACY_NAVIGATION_VERSION}). Resetting app router to keep it in sync.`);
+            appNavigation.replace('/');
+        }
+    });
+}
+//# sourceMappingURL=legacy-app-navigation-fix.js.map

package/dist/esm/utils/legacy-app-navigation-fix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-app-navigation-fix.js","sourceRoot":"","sources":["../../../src/utils/legacy-app-navigation-fix.ts"],"names":[],"mappings":"AAGA,kEAAkE;AAClE,OAAO,WAAW,CAAC;AAEnB,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAUpC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAgC;IACrE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAEvB,OAAO,KAAK,CAAC,gBAAgB,CAAC,8BAA8B,EAAE,CAAC,CAAC,EAAE,EAAE;QAClE,4EAA4E;QAC5E,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC;QAExC,MAAM,aAAa,GAAI,UAAmD,CAAC,UAAU,CAAC;QAEtF,2EAA2E;QAC3E,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,oFAAoF;QACpF,IAAI,aAAa,CAAC,OAAO,CAAC,KAAK,GAAG,yBAAyB,EAAE,CAAC;YAC5D,OAAO,CAAC,IAAI,CACV,4BAA4B,MAAM,sBAAsB,aAAa,CAAC,OAAO,CAAC,KAAK,OAAO,yBAAyB,6CAA6C,CACjK,CAAC;YACF,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/utils/resolve-context-from-url.js

@@ -0,0 +1,37 @@
+/**
+ * Creates a resolver that decodes a context ID from the current URL using
+ * the provided adapters and sets it on the context provider.
+ *
+ * Iterates adapters in priority order — the first static adapter whose
+ * `decode()` returns a non-null value wins. Factory adapters are skipped
+ * since no app context is available at initial resolution time.
+ *
+ * @param adapters - Registered adapters, evaluated in order.
+ * @param origin - The origin to use when constructing the URL (defaults to `window.location.origin`).
+ * @returns An async function compatible with `ContextNavigationConfig.resolveInitialContext`.
+ */
+export const resolveContextFromUrl = (adapters, origin) => async ({ context, navigation, }) => {
+    const resolvedOrigin = origin ?? window.location.origin;
+    const currentURL = new URL(`${navigation.path.pathname}${navigation.path.search ?? ''}`, resolvedOrigin);
+    // Adapters are evaluated in registration order — first successful decode wins
+    for (const entry of adapters) {
+        // Factory adapters need app context to decode — skip until an app is active
+        if (typeof entry === 'function') {
+            // No app is mounted yet — factory adapters cannot produce a valid decode
+            continue;
+        }
+        const contextId = entry.decode(currentURL);
+        // First adapter to decode a valid ID wins — apply context and stop processing
+        if (contextId) {
+            try {
+                await context.setCurrentContextByIdAsync(contextId);
+            }
+            catch (err) {
+                // Log the error but do not throw — initial context resolution is best-effort
+                console.warn('ContextNavigation: failed to resolve initial context from URL', contextId, err);
+            }
+            return;
+        }
+    }
+};
+//# sourceMappingURL=resolve-context-from-url.js.map

package/dist/esm/utils/resolve-context-from-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-context-from-url.js","sourceRoot":"","sources":["../../../src/utils/resolve-context-from-url.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,CAAC,QAAyC,EAAE,MAAe,EAAE,EAAE,CAC/D,KAAK,EAAE,EACL,OAAO,EACP,UAAU,GAIX,EAAiB,EAAE;IAClB,MAAM,cAAc,GAAG,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,EAC5D,cAAc,CACf,CAAC;IAEF,8EAA8E;IAC9E,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,4EAA4E;QAC5E,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,yEAAyE;YACzE,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC3C,8EAA8E;QAC9E,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,0BAA0B,CAAC,SAAS,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,6EAA6E;gBAC7E,OAAO,CAAC,IAAI,CACV,+DAA+D,EAC/D,SAAS,EACT,GAAG,CACJ,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

package/dist/esm/utils/url/build-app-route.js

@@ -0,0 +1,20 @@
+/**
+ * Builds `/apps/:appKey[/:contextId][/:rest]` from named segments.
+ * Inverse of `parseAppRoute` — used by all write/upsert helpers.
+ *
+ * @param appKey - The application key (e.g. `'my-app'`).
+ * @param contextId - Optional context id to embed as the third path segment.
+ * @param rest - Optional sub-route tail to append after the context segment.
+ * @returns The constructed app route path string.
+ */
+export const buildAppRoute = (appKey, contextId, rest) => {
+    const path = [`/apps/${appKey}`];
+    // Context segment is optional — omitted when no context is actively selected
+    if (contextId)
+        path.push(`${contextId}`);
+    // Preserve any sub-route depth that exists beyond the context segment
+    if (rest)
+        path.push(`${rest}`);
+    return path.join('/');
+};
+//# sourceMappingURL=build-app-route.js.map

package/dist/esm/utils/url/build-app-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-app-route.js","sourceRoot":"","sources":["../../../../src/utils/url/build-app-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAE,SAAkB,EAAE,IAAa,EAAU,EAAE;IACzF,MAAM,IAAI,GAAG,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAEjC,6EAA6E;IAC7E,IAAI,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,CAAC;IAEzC,sEAAsE;IACtE,IAAI,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IAE/B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC,CAAC"}

package/dist/esm/utils/url/build-context-url-for-strategy.js

@@ -0,0 +1,43 @@
+import { CONTEXT_QUERY_PARAM_KEY } from '../../constants';
+import { parseAppRoute } from './parse-app-route';
+import { buildAppRoute } from './build-app-route';
+/**
+ * Builds the correct context URL for the given routing strategy.
+ *
+ * Designed for `setContextPathGenerator` — the adapter layer handles
+ * runtime URL encoding; this is only for the context module's own hooks.
+ *
+ * @param contextId - The context id to embed in the URL, or `undefined` to clear it.
+ * @param path - The current URL path to modify.
+ * @param routingStrategy - The routing strategy (`'query'` or `'path'`).
+ * @returns The modified URL path with the context id applied.
+ */
+export const buildContextUrlForStrategy = (contextId, path, routingStrategy) => {
+    // Query routing keeps context out of the path — safer for apps that parse their own routes
+    if (routingStrategy === 'query') {
+        try {
+            const url = new URL(path, 'http://localhost');
+            // Keep the query param in sync with context lifecycle — cleared when context is removed
+            if (contextId) {
+                url.searchParams.set(CONTEXT_QUERY_PARAM_KEY, contextId);
+            }
+            else {
+                url.searchParams.delete(CONTEXT_QUERY_PARAM_KEY);
+            }
+            // Restore $ from %24 encoding
+            url.search = url.search.replace(/%24/gi, '$');
+            return `${url.pathname}${url.search}${url.hash}`;
+        }
+        catch {
+            return path;
+        }
+    }
+    // Path routing embeds the context id directly in the URL structure
+    const match = parseAppRoute(path);
+    // Path is not a recognised app route — return it unchanged
+    if (!match) {
+        return path;
+    }
+    return buildAppRoute(match.appKey, contextId ?? undefined);
+};
+//# sourceMappingURL=build-context-url-for-strategy.js.map

package/dist/esm/utils/url/build-context-url-for-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-context-url-for-strategy.js","sourceRoot":"","sources":["../../../../src/utils/url/build-context-url-for-strategy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,SAA6B,EAC7B,IAAY,EACZ,eAAoD,EAC5C,EAAE;IACV,2FAA2F;IAC3F,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;YAC9C,wFAAwF;YACxF,IAAI,SAAS,EAAE,CAAC;gBACd,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;YACnD,CAAC;YACD,8BAA8B;YAC9B,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC9C,OAAO,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAElC,2DAA2D;IAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,SAAS,CAAC,CAAC;AAC7D,CAAC,CAAC"}

package/dist/esm/utils/url/index.js

@@ -0,0 +1,7 @@
+export { parseAppRoute } from './parse-app-route';
+export { buildAppRoute } from './build-app-route';
+export { CONTEXT_QUERY_PARAM_KEY, UUID_PATTERN } from '../../constants';
+export { stripContextQueryParam } from './strip-context-query-param';
+export { resolveContextIdFromUrl } from './resolve-context-id-from-url';
+export { buildContextUrlForStrategy } from './build-context-url-for-strategy';
+//# sourceMappingURL=index.js.map

package/dist/esm/utils/url/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/url/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/esm/utils/url/parse-app-route.js

@@ -0,0 +1,47 @@
+import { normalizePath } from '../../helpers';
+/**
+ * URLPattern for the standard Fusion portal app route:
+ *
+ *   /apps/:appKey              — bare app route
+ *   /apps/:appKey/:contextId   — app with context
+ *   /apps/:appKey/:contextId/… — app with context + sub-routes
+ *
+ * Named groups give direct access to path segments.
+ * Instantiated once at module scope — pattern compilation is O(1) thereafter.
+ */
+const APP_ROUTE_PATTERN = new URLPattern({
+    pathname: '/apps/:appKey/:contextId?/:rest*',
+});
+/**
+ * Parses `/apps/:appKey/:contextId?/…rest` into named segments.
+ *
+ * Trailing slashes are stripped before matching because URLPattern's
+ * pathname matching does not treat `/apps/my-app/` and `/apps/my-app`
+ * as equivalent.
+ *
+ * @param pathname - The URL pathname to parse.
+ * @returns Named segments, or undefined if the pathname is not an app route.
+ */
+export const parseAppRoute = (pathname) => {
+    // URLPattern requires an absolute path — prepend slash if missing
+    if (!pathname[0] || pathname[0] !== '/') {
+        pathname = `/${pathname}`;
+    }
+    const normalized = normalizePath(pathname);
+    const result = APP_ROUTE_PATTERN.exec({ pathname: normalized });
+    // Pathname does not match the /apps/:appKey pattern
+    if (!result) {
+        return undefined;
+    }
+    const { appKey, contextId, rest } = result.pathname.groups;
+    // Guard against an empty appKey capture group (malformed pattern match)
+    if (!appKey) {
+        return undefined;
+    }
+    return {
+        appKey,
+        contextId: contextId || undefined,
+        rest: rest || undefined,
+    };
+};
+//# sourceMappingURL=parse-app-route.js.map

package/dist/esm/utils/url/parse-app-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-app-route.js","sourceRoot":"","sources":["../../../../src/utils/url/parse-app-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C;;;;;;;;;GASG;AACH,MAAM,iBAAiB,GAAG,IAAI,UAAU,CAAC;IACvC,QAAQ,EAAE,kCAAkC;CAC7C,CAAC,CAAC;AAWH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAA6B,EAAE;IAC3E,kEAAkE;IAClE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QACxC,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;IAEhE,oDAAoD;IACpD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IAE3D,wEAAwE;IACxE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,MAAM;QACN,SAAS,EAAE,SAAS,IAAI,SAAS;QACjC,IAAI,EAAE,IAAI,IAAI,SAAS;KACxB,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/utils/url/resolve-context-id-from-url.js

@@ -0,0 +1,29 @@
+import { UUID_PATTERN, CONTEXT_QUERY_PARAM_KEY } from '../../constants';
+import { parseAppRoute } from './parse-app-route';
+/**
+ * Extracts a context id from a URL — checks query param first, falls back to path segment.
+ * Designed for use with `setContextPathExtractor`.
+ * @param path - The URL path to parse.
+ * @returns The context id, or `undefined` if none was found.
+ */
+export const resolveContextIdFromUrl = (path) => {
+    try {
+        const url = new URL(path, 'http://localhost');
+        const fromQuery = url.searchParams.get(CONTEXT_QUERY_PARAM_KEY) ?? undefined;
+        // Query params are the explicit/authoritative way to set context — path is a fallback
+        if (fromQuery) {
+            return fromQuery;
+        }
+    }
+    catch {
+        // path may not be a valid URL — continue to path parsing
+    }
+    // Context may be embedded in the path when no query param is present
+    const match = parseAppRoute(path);
+    // Guard against non-context path segments — parseAppRoute can match non-UUID routes
+    if (match?.contextId && UUID_PATTERN.test(match.contextId)) {
+        return match.contextId;
+    }
+    return undefined;
+};
+//# sourceMappingURL=resolve-context-id-from-url.js.map

package/dist/esm/utils/url/resolve-context-id-from-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-context-id-from-url.js","sourceRoot":"","sources":["../../../../src/utils/url/resolve-context-id-from-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAsB,EAAE;IAC1E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,SAAS,CAAC;QAE7E,sFAAsF;QACtF,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;IAED,qEAAqE;IACrE,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAElC,oFAAoF;IACpF,IAAI,KAAK,EAAE,SAAS,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC,SAAS,CAAC;IACzB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/dist/esm/utils/url/strip-context-query-param.js

@@ -0,0 +1,20 @@
+import { CONTEXT_QUERY_PARAM_KEY } from '../../constants';
+/**
+ * Removes the `$contextId` query parameter from a URL in-place.
+ *
+ * Path and custom adapters encode context in the URL path, not the query
+ * string. If a previous adapter (or an external link) left `$contextId`
+ * in the query, carrying it forward creates a confusing duplicate signal.
+ * This utility strips it so the URL only contains the path-based encoding.
+ *
+ * @param url - The URL object to mutate (parameter is deleted in-place).
+ */
+export function stripContextQueryParam(url) {
+    // Only mutate the URL if the param is actually present
+    if (url.searchParams.has(CONTEXT_QUERY_PARAM_KEY)) {
+        url.searchParams.delete(CONTEXT_QUERY_PARAM_KEY);
+        // Restore $ from %24 encoding in remaining params
+        url.search = url.search.replace(/%24/gi, '$');
+    }
+}
+//# sourceMappingURL=strip-context-query-param.js.map

package/dist/esm/utils/url/strip-context-query-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-context-query-param.js","sourceRoot":"","sources":["../../../../src/utils/url/strip-context-query-param.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAQ;IAC7C,uDAAuD;IACvD,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;QACjD,kDAAkD;QAClD,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}