@apexnative/navigation 0.0.0-stage → 1.0.0-alpha.0

package/lib/module/api/app/createNavigation.js

@@ -0,0 +1,365 @@
+"use strict";
+
+import { setDefaultOptions, setRoot } from "../../engine/commands.js";
+import { enableSlots, withSlots } from "../../engine/slots.js";
+import { listenToNativeScreens, startHost } from "../../engine/nativeScreens.js";
+import { listenToSplitViews } from "../../engine/places.js";
+import { hasNativeScreenHooks } from "../../engine/screens.js";
+import { addNavigationListeners } from "../events/navigationEvents.js";
+import { getNavigationState, listenToNavigationState } from "../state/navigationState.js";
+import { watchSideMenus } from "../commands/sideMenus.js";
+import { listenToNativeScreenCalls } from "../screens/nativeScreenCalls.js";
+import { buildRoot, withDefaultTransition } from "../layout/Root.js";
+import { registerScreens } from "../screens/registerScreens.js";
+import { getAppContext, setAppContext } from "../context/appContext.js";
+import { initTheme, themedDefaultOptions } from "../theme/theme.js";
+import { setActiveApp } from "./activeApp.js";
+import { setStartFailure, START_FAILURE_SCREEN, startFailureScreen } from "./startFailure.js";
+import { releaseSplash, showsSplash, showSplash, SPLASH_ROOT, SPLASH_SCREEN, splashDone } from "./splash.js";
+import { launchState } from "../../engine/launchState.js";
+import { watchBackListeners } from "../../engine/backListeners.js";
+import { resolveRoot } from "./roots.js";
+import { launchLink, launchRoot, linksRelaunched, linksStarted, reportLink, setupLinking } from "../linking/linking.js";
+const NAVIGATION_APP = Symbol('apexnative.navigation.app');
+
+/** Where an error that goes to `onError` came from. */
+
+/** The navigation made by `createNavigation`, for `AppRegistry.registerComponent`. */
+
+// What starts each app: AppRegistry calls it on every AppLaunched, and nothing else does.
+const starts = new WeakMap();
+
+/** Starts the app, or brings back its root when the native side launches again. */
+export function startApp(app) {
+  const start = starts.get(app);
+  if (!start) throw new Error('[navigation] Not an app made by createNavigation');
+  return start();
+}
+
+// The screens of each group by group name, for the types.
+
+/** Every screen of the app: those of `screens` and of every group. */
+
+/** The first root: a layout, or a function making it from the context. */
+
+/** One root: the app always starts with it. */
+
+/** Named roots to switch between, such as signed out and signed in. */
+
+/** What `createNavigation` takes: `screens` and `root`, or `roots` with `initialRoot`; every other key is optional. */
+
+/**
+ * The roots, checked against the screens of the config itself: the app's registered type is made from this config,
+ * so it can't check it.
+ */
+
+export function isNavigationApp(value) {
+  return typeof value === 'object' && value !== null && starts.has(value);
+}
+
+/**
+ * The app's navigation in one object: its screens, its first root, how the screens look and show, the data every
+ * screen reads, and what runs at launch. `AppRegistry.registerComponent` in `index.js` takes it, and the app starts
+ * from it when the native side launches.
+ *
+ * @example
+ * export const Navigation = createNavigation({
+ *   screens: { Home: HomeScreen, Details: DetailsScreen },
+ *   root: 'Home',
+ * });
+ */
+export function createNavigation(config) {
+  // Counted from here: a "back again to leave" listener of the app's entry file comes after this call.
+  watchBackListeners();
+  // idle: not started yet, or the last start failed. mounting: the first root is on its way. mounted: it is shown.
+  let phase = 'idle';
+  let screensRegistered = false;
+  // The splash shows at the first start of this runtime only: a start that failed and runs again goes without it.
+  let splashChecked = false;
+  let listening = false;
+  let prepared;
+  let markMounted;
+  // A new activity came while the first root was on its way (Android): its link is taken once that root is shown.
+  let relaunchedWhileMounting = false;
+  // A first root whose activity went before it showed waits for the next one (Android).
+  const relaunchWaiters = [];
+  function relaunchedAfter(launch) {
+    if (launchState.launch > launch) return Promise.resolve();
+    return new Promise(resolve => relaunchWaiters.push(resolve));
+  }
+  const mounted = new Promise(resolve => {
+    markMounted = resolve;
+  });
+
+  // willMount runs once per JavaScript runtime; after a failure the next launch runs it again.
+  function prepare() {
+    if (!prepared) {
+      prepared = Promise.resolve().then(() => config.willMount?.());
+      prepared.catch(() => {
+        prepared = undefined;
+      });
+      if (__DEV__ && config.willMount) warnIfLong(prepared);
+    }
+    return prepared;
+  }
+  function firstRoot(context) {
+    if (config.roots) {
+      const {
+        roots,
+        initialRoot
+      } = config;
+      const target = initialRoot(context);
+      const [name, ...param] = Array.isArray(target) ? target : [target];
+      return resolveRoot(roots, name, param);
+    }
+    const {
+      root
+    } = config;
+    return buildRoot(typeof root === 'function' ? root(context) : root);
+  }
+  async function mount() {
+    phase = 'mounting';
+    // The state before the first root: the links wait for a newer one, which tells the screen they act from.
+    const stateBefore = getNavigationState();
+    let link;
+    let linkHandled = false;
+    try {
+      if (!screensRegistered) {
+        const wrapper = {
+          errorFallback: config.errorFallback,
+          loadingFallback: config.loadingFallback,
+          onError: config.onError && ((error, screen, componentStack) => config.onError?.(error, {
+            type: 'screen',
+            screen,
+            componentStack
+          }))
+        };
+        registerScreens([{
+          source: 'screens',
+          screens: config.screens ?? {}
+        }, ...Object.entries(config.groups ?? {}).map(([group, {
+          screens,
+          options
+        }]) => ({
+          source: `the group '${group}'`,
+          screens,
+          options
+        })), ...(config.errorFallback ? [{
+          source: 'the start',
+          screens: {
+            [START_FAILURE_SCREEN]: startFailureScreen(config.errorFallback)
+          }
+        }] : [])], {
+          ...wrapper,
+          provider: config.screenProvider
+        });
+        // The splash renders before willMount ends: a root of its own, without the app's providers, which may need what
+        // willMount prepares.
+        if (config.splash) {
+          registerScreens([{
+            source: 'the splash',
+            screens: {
+              [SPLASH_SCREEN]: config.splash.component
+            },
+            ownRoot: true
+          }], {
+            ...wrapper,
+            // A splash that failed to render can't call hide(): the start goes on without waiting for it.
+            onError: (error, screen, componentStack) => {
+              releaseSplash();
+              wrapper.onError?.(error, screen, componentStack);
+            }
+          });
+        }
+        screensRegistered = true;
+      }
+      // The link that launched the app is asked for first: on iOS the first React content to appear (the host below,
+      // LogBox) would send it to Linking as a `url` event otherwise.
+      const linkTaken = config.linking ? launchLink() : undefined;
+      // The host of the native screens' hooks starts while willMount runs, so a native first screen doesn't wait for
+      // it; a command that needs it reports a failure.
+      if (hasNativeScreenHooks()) startHost().catch(() => {});
+      // The app's splash, once, on a cold start: it shows while willMount and the launch link run.
+      const splash = !splashChecked && showsSplash(config.splash) ? config.splash : undefined;
+      splashChecked = true;
+      // An empty id: the activity went before the splash showed (Android); it shows nothing until the next launch
+      // releases it.
+      const splashLeaves = splash && showSplash(splash, () => setRoot(SPLASH_ROOT).then(id => id === '' ? new Promise(() => {}) : id));
+      await prepare();
+      const context = getAppContext();
+      // The link that launched the app makes the first root when its route has `start`; otherwise it runs after it.
+      link = await linkTaken;
+      const linked = launchRoot(link);
+      linkHandled = linked.handled;
+      // The first root replaces the splash once it may leave, with the splash's transition unless it has its own.
+      await splashLeaves;
+      let sent;
+      const afterSplash = root => {
+        if (!splash) return root;
+        sent = {
+          root,
+          withTransition: withDefaultTransition(root, splash.transition ?? 'fade')
+        };
+        return sent.withTransition;
+      };
+      const rootLaunch = launchState.launch;
+      let rootId = linked.root && (await setLinkedRoot(afterSplash(linked.root), link.url));
+      rootId ??= await withSlots(() => setRoot(afterSplash(firstRoot(context))));
+      // A new activity sets the root again as it was meant, without the splash's transition: there is no splash then.
+      if (sent && launchState.root === sent.withTransition) launchState.root = sent.root;
+      splashDone();
+      // The activity can be replaced while willMount runs: the root then went to the old one. Android answers without
+      // an id when the activity went before the root showed: the next activity sets it again, and the start waits for
+      // that, still mounting so that the launch wakes it (what waits for the first root would find no screens).
+      let sentIn = rootLaunch;
+      for (let shown = rootId !== '';; shown = false) {
+        if (!shown) await relaunchedAfter(sentIn);
+        if ((await restoreRoot()) !== '') break;
+        sentIn = launchState.rootLaunch;
+      }
+      phase = 'mounted';
+      markMounted();
+      config.didMount?.(context);
+    } catch (error) {
+      phase = 'idle';
+      splashDone();
+      if (config.errorFallback && screensRegistered) await showStartFailure(error);
+      throw error;
+    }
+    // The links don't hold the start, and what they do is not the start's: a failing route goes to onError as a link.
+    if (config.linking) {
+      linksStarted(link, linkHandled, stateBefore).then(() => relaunchedWhileMounting ? linksRelaunched(stateBefore) : undefined);
+    }
+  }
+
+  // A root of `start` the native side can't set (a screen not in `screens`) is the link's failure: the usual first
+  // root shows instead, and Try again isn't needed. The root's id, or undefined when it failed.
+  async function setLinkedRoot(root, url) {
+    try {
+      return await withSlots(() => setRoot(root));
+    } catch (error) {
+      reportLink(error, url);
+      return undefined;
+    }
+  }
+
+  // A failed start shows errorFallback as the first root; a new try that fails too shows its error there.
+  let failureShown = false;
+  async function showStartFailure(error) {
+    setStartFailure({
+      error,
+      retry: () => {
+        if (phase === 'idle') reportStart(mount);
+      }
+    });
+    if (failureShown) return;
+    failureShown = true;
+    try {
+      await withSlots(() => setRoot({
+        root: {
+          component: {
+            name: START_FAILURE_SCREEN
+          }
+        }
+      }));
+    } catch {
+      failureShown = false;
+    }
+  }
+
+  // The errors of a start go to onError, or to React Native as errors of the app.
+  async function reportStart(run) {
+    try {
+      await run();
+    } catch (error) {
+      if (!config.onError) throw error;
+      config.onError(error, {
+        type: 'start'
+      });
+    }
+  }
+  async function launch() {
+    setActiveApp({
+      roots: config.roots,
+      presentation: config.presentation,
+      mounted
+    });
+    if (!listening) {
+      listening = true;
+      // The edges of `safeArea` go under the app's options; the window's color goes with them, as the native side
+      // takes it from the default options.
+      initTheme(config.theme, {
+        under: config.safeArea && {
+          layout: {
+            safeAreaEdges: config.safeArea.edges
+          }
+        },
+        options: config.options,
+        over: config.window && {
+          window: config.window
+        }
+      }, config.direction);
+      if (config.context !== undefined) setAppContext(config.context);
+      if (config.appProvider) enableSlots(config.appProvider);
+      listenToNavigationState();
+      watchSideMenus();
+      listenToNativeScreens();
+      listenToSplitViews();
+      listenToNativeScreenCalls();
+      if (config.listeners) addNavigationListeners(config.listeners);
+    }
+    launchState.launch++;
+    // A new activity has no default options: the last ones set come back, else the theme's and the app's.
+    const defaultOptions = launchState.defaultOptions ?? themedDefaultOptions();
+    if (defaultOptions) setDefaultOptions(defaultOptions);
+    if (phase === 'idle') return mount();
+    if (phase === 'mounted') {
+      const stateBefore = getNavigationState();
+      await restoreRoot();
+      if (config.linking) linksRelaunched(stateBefore);
+      return;
+    }
+    // mounting: the first launch is still on its way and restores the root itself when it is done. The splash went
+    // with the old activity and the new one doesn't show it: the start doesn't wait for it.
+    relaunchedWhileMounting = true;
+    releaseSplash();
+    relaunchWaiters.splice(0).forEach(resume => resume());
+  }
+
+  // The links listen from now on: one that comes before the native side launches waits for the first root.
+  if (config.linking) {
+    setupLinking(config.linking, {
+      roots: config.roots,
+      onError: config.onError && ((error, url) => config.onError?.(error, {
+        type: 'link',
+        url
+      }))
+    });
+  }
+  const app = {
+    [NAVIGATION_APP]: true
+  };
+  starts.set(app, () => reportStart(launch));
+  return app;
+}
+
+// A willMount that never ends keeps the splash screen for good: in development the app hears of it.
+function warnIfLong(willMount) {
+  const timer = setTimeout(() => console.warn('[navigation] willMount: still running after 10 s; the splash stays until it ends'), 10_000);
+  const clear = () => clearTimeout(timer);
+  willMount.then(clear, clear);
+}
+
+/**
+ * Sets the last root again when it was set before this launch of the native side; the id of the last root it set, empty
+ * when its activity went before it showed (Android), undefined when there was nothing to set.
+ */
+async function restoreRoot() {
+  let id;
+  while (launchState.root && launchState.rootLaunch !== launchState.launch) {
+    const root = launchState.root;
+    id = await withSlots(() => setRoot(root));
+  }
+  return id;
+}
+//# sourceMappingURL=createNavigation.js.map

package/lib/module/api/app/createNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["setDefaultOptions","setRoot","enableSlots","withSlots","listenToNativeScreens","startHost","listenToSplitViews","hasNativeScreenHooks","addNavigationListeners","getNavigationState","listenToNavigationState","watchSideMenus","listenToNativeScreenCalls","buildRoot","withDefaultTransition","registerScreens","getAppContext","setAppContext","initTheme","themedDefaultOptions","setActiveApp","setStartFailure","START_FAILURE_SCREEN","startFailureScreen","releaseSplash","showsSplash","showSplash","SPLASH_ROOT","SPLASH_SCREEN","splashDone","launchState","watchBackListeners","resolveRoot","launchLink","launchRoot","linksRelaunched","linksStarted","reportLink","setupLinking","NAVIGATION_APP","Symbol","starts","WeakMap","startApp","app","start","get","Error","isNavigationApp","value","has","createNavigation","config","phase","screensRegistered","splashChecked","listening","prepared","markMounted","relaunchedWhileMounting","relaunchWaiters","relaunchedAfter","launch","Promise","resolve","push","mounted","prepare","then","willMount","catch","undefined","__DEV__","warnIfLong","firstRoot","context","roots","initialRoot","target","name","param","Array","isArray","root","mount","stateBefore","link","linkHandled","wrapper","errorFallback","loadingFallback","onError","error","screen","componentStack","type","source","screens","Object","entries","groups","map","group","options","provider","screenProvider","splash","component","ownRoot","linkTaken","linking","splashLeaves","id","linked","handled","sent","afterSplash","withTransition","transition","rootLaunch","rootId","setLinkedRoot","url","sentIn","shown","restoreRoot","didMount","showStartFailure","failureShown","retry","reportStart","run","presentation","theme","under","safeArea","layout","safeAreaEdges","edges","over","window","direction","appProvider","listeners","defaultOptions","splice","forEach","resume","set","timer","setTimeout","console","warn","clear","clearTimeout"],"sourceRoot":"../../../../src","sources":["api/app/createNavigation.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/api/app/roots.js

@@ -0,0 +1,20 @@
+"use strict";
+
+import { buildRoot } from "../layout/Root.js";
+
+/** A root of the app: its layout, or a function making it from a param. */
+
+/** The screens a root of `roots` shows: those of its layout, or of the layout its function makes. */
+
+/** The param a root takes: none for a layout or a function without one. */
+
+/** A root to show: its name, or `[name, param]` for a root that takes a param. */
+
+export function resolveRoot(roots, name, param) {
+  const value = roots?.[name];
+  if (value === undefined) {
+    throw new Error(`[navigation] There is no root '${name}' in the roots of createNavigation`);
+  }
+  return buildRoot(typeof value === 'function' ? value(...param) : value);
+}
+//# sourceMappingURL=roots.js.map

package/lib/module/api/app/roots.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["buildRoot","resolveRoot","roots","name","param","value","undefined","Error"],"sourceRoot":"../../../../src","sources":["api/app/roots.ts"],"mappings":";;AACA,SAASA,SAAS,QAA0C,mBAAgB;;AAE5E;;AAKA;;AAKA;;AAOA;;AAOA,OAAO,SAASC,WAAWA,CACzBC,KAA2B,EAC3BC,IAAY,EACZC,KAAgB,EACJ;EACZ,MAAMC,KAAK,GAAGH,KAAK,GAAGC,IAAI,CAAC;EAC3B,IAAIE,KAAK,KAAKC,SAAS,EAAE;IACvB,MAAM,IAAIC,KAAK,CAAC,kCAAkCJ,IAAI,oCAAoC,CAAC;EAC7F;EACA,OAAOH,SAAS,CACd,OAAOK,KAAK,KAAK,UAAU,GAAIA,KAAK,CAAwC,GAAGD,KAAK,CAAC,GAAGC,KAC1F,CAAC;AACH","ignoreList":[]}

package/lib/module/api/app/splash.js

@@ -0,0 +1,124 @@
+"use strict";
+
+import { getStartInfo } from "../../engine/native.js";
+/** The screen of the app's splash in React Native: the first root of a cold start. */
+export const SPLASH_SCREEN = 'ApexNavigation.Splash';
+
+/**
+ * The app's own splash in React Native: an animation, a progress. It shows after the native splash on a cold start
+ * of the app, once per process: not after a reload of the JavaScript, and not when Android makes a new activity while
+ * the JavaScript runs on.
+ */
+
+/** The size of the native splash's logo: points on iOS, dp on Android. */
+
+/** What `useSplash` returns. */
+
+// hide() came: the splash may leave once the rest is done too.
+let hideCalled = false;
+let hideWaiter;
+function hide() {
+  hideCalled = true;
+  hideWaiter?.();
+}
+let splash;
+
+/**
+ * The app's splash in React Native: lets it leave (`hide: 'manual'`), and gives the size of the native splash's logo
+ * to start an animation from.
+ *
+ * @example
+ * function Splash() {
+ *   const { hide, logo } = useSplash();
+ *   // … the logo at logo.width × logo.height in the middle of the window, then an animation that calls hide()
+ * }
+ */
+export function useSplash() {
+  splash ??= {
+    hide,
+    logo: getStartInfo().splashLogo ?? undefined
+  };
+  return splash;
+}
+
+/** Whether the splash shows at this start: the app has one, and the JavaScript runs for the first time in the process. */
+export function showsSplash(config) {
+  return config !== undefined && getStartInfo().coldStart;
+}
+
+/**
+ * The splash as the first root: at once, as it continues the native splash, over the whole window. Its own screen
+ * options can't hold this, as `component` is any component.
+ */
+export const SPLASH_ROOT = {
+  root: {
+    component: {
+      name: SPLASH_SCREEN,
+      options: {
+        layout: {
+          safeAreaEdges: []
+        },
+        animations: {
+          setRoot: {
+            enter: {
+              enabled: false,
+              waitForRender: true
+            },
+            exit: {
+              enabled: false
+            }
+          }
+        }
+      }
+    }
+  }
+};
+
+// The splash left, or the start ended without it.
+let done = false;
+// Ends the wait for the splash at once.
+let release;
+
+/**
+ * Shows the splash and resolves once it may leave as far as it is concerned: it is on screen, `minDuration` passed
+ * and, with `hide: 'manual'`, `hide()` came; or at once on `releaseSplash()`. A splash that failed to show holds
+ * nothing: the native splash stays until the first root.
+ */
+export function showSplash(config, show) {
+  const {
+    minDuration = 0,
+    hide: mode = 'auto'
+  } = config;
+  const hidden = mode === 'manual' && !hideCalled ? new Promise(resolve => {
+    hideWaiter = resolve;
+  }) : undefined;
+  const released = new Promise(resolve => {
+    release = resolve;
+  });
+  const shown = show().then(() => Promise.all([delay(minDuration), hidden]).then(() => {}), error => {
+    // A start that failed replaces the splash before it shows: its own error says enough.
+    if (__DEV__ && !done) console.warn(`[navigation] splash: it didn't show (${String(error)})`);
+  });
+  return Promise.race([shown, released]);
+}
+
+/**
+ * The splash can't leave by itself any more, and the start goes on at once: its screen went with an Android activity
+ * (the new one doesn't show it, and its setRoot may never end), or its component failed to render and can't call
+ * `hide()`.
+ */
+export function releaseSplash() {
+  release?.();
+}
+
+/** The splash left, or won't show: hide() does nothing from now on. */
+export function splashDone() {
+  done = true;
+  hideCalled = true;
+  hideWaiter = undefined;
+  release = undefined;
+}
+function delay(ms) {
+  return ms > 0 ? new Promise(resolve => setTimeout(resolve, ms)) : undefined;
+}
+//# sourceMappingURL=splash.js.map

package/lib/module/api/app/splash.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getStartInfo","SPLASH_SCREEN","hideCalled","hideWaiter","hide","splash","useSplash","logo","splashLogo","undefined","showsSplash","config","coldStart","SPLASH_ROOT","root","component","name","options","layout","safeAreaEdges","animations","setRoot","enter","enabled","waitForRender","exit","done","release","showSplash","show","minDuration","mode","hidden","Promise","resolve","released","shown","then","all","delay","error","__DEV__","console","warn","String","race","releaseSplash","splashDone","ms","setTimeout"],"sourceRoot":"../../../../src","sources":["api/app/splash.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/api/app/startFailure.js

@@ -0,0 +1,38 @@
+"use strict";
+
+import React, { useContext, useSyncExternalStore } from 'react';
+import { ScreenContext } from "../screens/registerScreens.js";
+
+/** The screen a failed start shows as the first root, in place of the splash screen: `errorFallback`. */
+import { jsx as _jsx } from "react/jsx-runtime";
+export const START_FAILURE_SCREEN = 'ApexNavigation.StartFailure';
+let failure;
+const listeners = new Set();
+
+/** The start failed: the screen shows this error, or the new one of a try that failed again. */
+export function setStartFailure(next) {
+  failure = next;
+  listeners.forEach(listener => listener());
+}
+function subscribe(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+/** The component of the screen: the app's `errorFallback` with the error of the start, its `retry` starts again. */
+export function startFailureScreen(Fallback) {
+  function StartFailure() {
+    const current = useSyncExternalStore(subscribe, () => failure);
+    const screen = useContext(ScreenContext);
+    if (!current || !screen) return null;
+    return /*#__PURE__*/_jsx(Fallback, {
+      error: current.error,
+      screen: screen,
+      retry: current.retry
+    });
+  }
+  return StartFailure;
+}
+//# sourceMappingURL=startFailure.js.map

package/lib/module/api/app/startFailure.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","useContext","useSyncExternalStore","ScreenContext","jsx","_jsx","START_FAILURE_SCREEN","failure","listeners","Set","setStartFailure","next","forEach","listener","subscribe","add","delete","startFailureScreen","Fallback","StartFailure","current","screen","error","retry"],"sourceRoot":"../../../../src","sources":["api/app/startFailure.tsx"],"mappings":";;AAAA,OAAOA,KAAK,IAAwBC,UAAU,EAAEC,oBAAoB,QAAQ,OAAO;AAEnF,SAASC,aAAa,QAAQ,+BAA4B;;AAE1D;AAAA,SAAAC,GAAA,IAAAC,IAAA;AACA,OAAO,MAAMC,oBAAoB,GAAG,6BAA6B;AAQjE,IAAIC,OAAiC;AACrC,MAAMC,SAAS,GAAG,IAAIC,GAAG,CAAa,CAAC;;AAEvC;AACA,OAAO,SAASC,eAAeA,CAACC,IAAkB,EAAE;EAClDJ,OAAO,GAAGI,IAAI;EACdH,SAAS,CAACI,OAAO,CAAEC,QAAQ,IAAKA,QAAQ,CAAC,CAAC,CAAC;AAC7C;AAEA,SAASC,SAASA,CAACD,QAAoB,EAAc;EACnDL,SAAS,CAACO,GAAG,CAACF,QAAQ,CAAC;EACvB,OAAO,MAAM;IACXL,SAAS,CAACQ,MAAM,CAACH,QAAQ,CAAC;EAC5B,CAAC;AACH;;AAEA;AACA,OAAO,SAASI,kBAAkBA,CAACC,QAA2C,EAAiB;EAC7F,SAASC,YAAYA,CAAA,EAAG;IACtB,MAAMC,OAAO,GAAGlB,oBAAoB,CAACY,SAAS,EAAE,MAAMP,OAAO,CAAC;IAC9D,MAAMc,MAAM,GAAGpB,UAAU,CAACE,aAAa,CAAC;IACxC,IAAI,CAACiB,OAAO,IAAI,CAACC,MAAM,EAAE,OAAO,IAAI;IACpC,oBAAOhB,IAAA,CAACa,QAAQ;MAACI,KAAK,EAAEF,OAAO,CAACE,KAAM;MAACD,MAAM,EAAEA,MAAO;MAACE,KAAK,EAAEH,OAAO,CAACG;IAAM,CAAE,CAAC;EACjF;EACA,OAAOJ,YAAY;AACrB","ignoreList":[]}