@ohos-ports/react-native-navigation 8.9.0-beta.0

package/lib/module/interfaces/CommandName.js

@@ -0,0 +1,22 @@
+"use strict";
+
+export let CommandName = /*#__PURE__*/function (CommandName) {
+  CommandName["SetRoot"] = "setRoot";
+  CommandName["SetDefaultOptions"] = "setDefaultOptions";
+  CommandName["MergeOptions"] = "mergeOptions";
+  CommandName["UpdateProps"] = "updateProps";
+  CommandName["ShowModal"] = "showModal";
+  CommandName["DismissModal"] = "dismissModal";
+  CommandName["DismissAllModals"] = "dismissAllModals";
+  CommandName["Push"] = "push";
+  CommandName["Pop"] = "pop";
+  CommandName["PopTo"] = "popTo";
+  CommandName["PopToRoot"] = "popToRoot";
+  CommandName["SetStackRoot"] = "setStackRoot";
+  CommandName["ShowOverlay"] = "showOverlay";
+  CommandName["DismissOverlay"] = "dismissOverlay";
+  CommandName["DismissAllOverlays"] = "dismissAllOverlays";
+  CommandName["GetLaunchArgs"] = "getLaunchArgs";
+  return CommandName;
+}({});
+//# sourceMappingURL=CommandName.js.map

package/lib/module/interfaces/CommandName.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CommandName"],"sourceRoot":"../../../src","sources":["interfaces/CommandName.ts"],"mappings":";;AAAA,WAAYA,WAAW,0BAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA","ignoreList":[]}

package/lib/module/interfaces/ComponentEvents.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ComponentEvents.js.map

package/lib/module/interfaces/ComponentEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["interfaces/ComponentEvents.ts"],"mappings":"","ignoreList":[]}

package/lib/module/interfaces/EventSubscription.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=EventSubscription.js.map

package/lib/module/interfaces/EventSubscription.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["interfaces/EventSubscription.ts"],"mappings":"","ignoreList":[]}

package/lib/module/interfaces/Events.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=Events.js.map

package/lib/module/interfaces/Events.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["interfaces/Events.ts"],"mappings":"","ignoreList":[]}

package/lib/module/interfaces/Layout.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=Layout.js.map

package/lib/module/interfaces/Layout.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["interfaces/Layout.ts"],"mappings":"","ignoreList":[]}

package/lib/module/interfaces/NavigationComponent.js

@@ -0,0 +1,21 @@
+"use strict";
+
+import React from 'react';
+export class NavigationComponent extends React.Component {
+  /**
+   * Options used to apply a style configuration when the screen appears.
+   *
+   * This field can either contain the concrete options to be applied, or a generator function
+   * which accepts props and returns an Options object.
+   */
+
+  componentWillAppear(_event) {}
+  componentDidAppear(_event) {}
+  componentDidDisappear(_event) {}
+  navigationButtonPressed(_event) {}
+  searchBarUpdated(_event) {}
+  searchBarCancelPressed(_event) {}
+  previewCompleted(_event) {}
+  screenPopped(_event) {}
+}
+//# sourceMappingURL=NavigationComponent.js.map

package/lib/module/interfaces/NavigationComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","NavigationComponent","Component","componentWillAppear","_event","componentDidAppear","componentDidDisappear","navigationButtonPressed","searchBarUpdated","searchBarCancelPressed","previewCompleted","screenPopped"],"sourceRoot":"../../../src","sources":["interfaces/NavigationComponent.ts"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AAczB,OAAO,MAAMC,mBAAmB,SAAiDD,KAAK,CAACE,SAAS,CAI9F;EACA;AACF;AACA;AACA;AACA;AACA;;EAGEC,mBAAmBA,CAACC,MAAgC,EAAE,CAAC;EACvDC,kBAAkBA,CAACD,MAA+B,EAAE,CAAC;EACrDE,qBAAqBA,CAACF,MAAkC,EAAE,CAAC;EAC3DG,uBAAuBA,CAACH,MAAoC,EAAE,CAAC;EAC/DI,gBAAgBA,CAACJ,MAA6B,EAAE,CAAC;EACjDK,sBAAsBA,CAACL,MAAmC,EAAE,CAAC;EAC7DM,gBAAgBA,CAACN,MAA6B,EAAE,CAAC;EACjDO,YAAYA,CAACP,MAAyB,EAAE,CAAC;AAC3C","ignoreList":[]}

package/lib/module/interfaces/NavigationComponentListener.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=NavigationComponentListener.js.map

package/lib/module/interfaces/NavigationComponentListener.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["interfaces/NavigationComponentListener.ts"],"mappings":"","ignoreList":[]}

package/lib/module/interfaces/NavigationComponentProps.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=NavigationComponentProps.js.map

package/lib/module/interfaces/NavigationComponentProps.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["interfaces/NavigationComponentProps.ts"],"mappings":"","ignoreList":[]}

package/lib/module/interfaces/NavigationFunctionComponent.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=NavigationFunctionComponent.js.map

package/lib/module/interfaces/NavigationFunctionComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["interfaces/NavigationFunctionComponent.ts"],"mappings":"","ignoreList":[]}

package/lib/module/interfaces/Options.js

@@ -0,0 +1,47 @@
+"use strict";
+
+// tslint:disable jsdoc-format
+
+// TODO: Import ColorValue instead when upgrading @types/react-native to 0.63+
+// Only assign PlatformColor or DynamicColorIOS as a Color symbol!
+
+export let OptionsModalPresentationStyle = /*#__PURE__*/function (OptionsModalPresentationStyle) {
+  OptionsModalPresentationStyle["formSheet"] = "formSheet";
+  OptionsModalPresentationStyle["pageSheet"] = "pageSheet";
+  OptionsModalPresentationStyle["overFullScreen"] = "overFullScreen";
+  OptionsModalPresentationStyle["overCurrentContext"] = "overCurrentContext";
+  OptionsModalPresentationStyle["currentContext"] = "currentContext";
+  OptionsModalPresentationStyle["popover"] = "popover";
+  OptionsModalPresentationStyle["fullScreen"] = "fullScreen";
+  OptionsModalPresentationStyle["none"] = "none";
+  return OptionsModalPresentationStyle;
+}({});
+export let OptionsModalTransitionStyle = /*#__PURE__*/function (OptionsModalTransitionStyle) {
+  OptionsModalTransitionStyle["coverVertical"] = "coverVertical";
+  OptionsModalTransitionStyle["crossDissolve"] = "crossDissolve";
+  OptionsModalTransitionStyle["flipHorizontal"] = "flipHorizontal";
+  OptionsModalTransitionStyle["partialCurl"] = "partialCurl";
+  return OptionsModalTransitionStyle;
+}({});
+
+/**
+ * Used to animate the actual content added to the hierarchy.
+ * Content can be a React component (component) or any other layout (Stack, BottomTabs etc)
+ */
+
+/**
+ * Used for describing stack commands animations.
+ */
+
+/**
+ * Used for configuring command animations
+ */
+
+/**
+ * Configure Android's NavigationBar
+ */
+
+/**
+ * Used for configuring and controlling the main window in iOS
+ */
+//# sourceMappingURL=Options.js.map

package/lib/module/interfaces/Options.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OptionsModalPresentationStyle","OptionsModalTransitionStyle"],"sourceRoot":"../../../src","sources":["interfaces/Options.ts"],"mappings":";;AAAA;;AAGA;AACA;;AAwMA,WAAYA,6BAA6B,0BAA7BA,6BAA6B;EAA7BA,6BAA6B;EAA7BA,6BAA6B;EAA7BA,6BAA6B;EAA7BA,6BAA6B;EAA7BA,6BAA6B;EAA7BA,6BAA6B;EAA7BA,6BAA6B;EAA7BA,6BAA6B;EAAA,OAA7BA,6BAA6B;AAAA;AAWzC,WAAYC,2BAA2B,0BAA3BA,2BAA2B;EAA3BA,2BAA2B;EAA3BA,2BAA2B;EAA3BA,2BAA2B;EAA3BA,2BAA2B;EAAA,OAA3BA,2BAA2B;AAAA;;AAmrCvC;AACA;AACA;AACA;;AAiJA;AACA;AACA;;AA0DA;AACA;AACA;;AA6BA;AACA;AACA;;AAWA;AACA;AACA","ignoreList":[]}

package/lib/module/interfaces/ProcessorSubscription.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ProcessorSubscription.js.map

package/lib/module/interfaces/ProcessorSubscription.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["interfaces/ProcessorSubscription.ts"],"mappings":"","ignoreList":[]}

package/lib/module/interfaces/Processors.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=Processors.js.map

package/lib/module/interfaces/Processors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["interfaces/Processors.ts"],"mappings":"","ignoreList":[]}

package/lib/module/linking/DeferredLinkQueue.js

@@ -0,0 +1,52 @@
+"use strict";
+
+/**
+ * Holds URLs while the linking pipeline is not ready and replays them in
+ * order once it becomes ready.
+ *
+ * Readiness is set by the owning `LinkingHandler` and reflects the combined
+ * state of:
+ *   - whether the first `setRoot` has resolved (so a modal can be presented),
+ *   - whether the user-supplied `isReady` predicate (if any) returns `true`.
+ */
+export class DeferredLinkQueue {
+  queue = [];
+  ready = false;
+  flushCallback = null;
+  setFlushCallback(callback) {
+    this.flushCallback = callback;
+  }
+  setReady(ready) {
+    const becameReady = !this.ready && ready;
+    this.ready = ready;
+    if (becameReady) {
+      this.flush();
+    }
+  }
+  isReady() {
+    return this.ready;
+  }
+
+  /**
+   * Enqueue a URL for later processing. Should only be called when the
+   * queue is not ready; the handler decides when to enqueue vs process.
+   */
+  enqueue(url) {
+    this.queue.push(url);
+  }
+  flush() {
+    if (!this.flushCallback) return;
+    const pending = [...this.queue];
+    this.queue = [];
+    for (const url of pending) {
+      this.flushCallback(url);
+    }
+  }
+  clear() {
+    this.queue = [];
+  }
+  pending() {
+    return [...this.queue];
+  }
+}
+//# sourceMappingURL=DeferredLinkQueue.js.map

package/lib/module/linking/DeferredLinkQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DeferredLinkQueue","queue","ready","flushCallback","setFlushCallback","callback","setReady","becameReady","flush","isReady","enqueue","url","push","pending","clear"],"sourceRoot":"../../../src","sources":["linking/DeferredLinkQueue.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,iBAAiB,CAAC;EACrBC,KAAK,GAAa,EAAE;EACpBC,KAAK,GAAG,KAAK;EACbC,aAAa,GAAmC,IAAI;EAErDC,gBAAgBA,CAACC,QAA+B,EAAQ;IAC7D,IAAI,CAACF,aAAa,GAAGE,QAAQ;EAC/B;EAEOC,QAAQA,CAACJ,KAAc,EAAQ;IACpC,MAAMK,WAAW,GAAG,CAAC,IAAI,CAACL,KAAK,IAAIA,KAAK;IACxC,IAAI,CAACA,KAAK,GAAGA,KAAK;IAClB,IAAIK,WAAW,EAAE;MACf,IAAI,CAACC,KAAK,CAAC,CAAC;IACd;EACF;EAEOC,OAAOA,CAAA,EAAY;IACxB,OAAO,IAAI,CAACP,KAAK;EACnB;;EAEA;AACF;AACA;AACA;EACSQ,OAAOA,CAACC,GAAW,EAAQ;IAChC,IAAI,CAACV,KAAK,CAACW,IAAI,CAACD,GAAG,CAAC;EACtB;EAEOH,KAAKA,CAAA,EAAS;IACnB,IAAI,CAAC,IAAI,CAACL,aAAa,EAAE;IACzB,MAAMU,OAAO,GAAG,CAAC,GAAG,IAAI,CAACZ,KAAK,CAAC;IAC/B,IAAI,CAACA,KAAK,GAAG,EAAE;IACf,KAAK,MAAMU,GAAG,IAAIE,OAAO,EAAE;MACzB,IAAI,CAACV,aAAa,CAACQ,GAAG,CAAC;IACzB;EACF;EAEOG,KAAKA,CAAA,EAAS;IACnB,IAAI,CAACb,KAAK,GAAG,EAAE;EACjB;EAEOY,OAAOA,CAAA,EAAa;IACzB,OAAO,CAAC,GAAG,IAAI,CAACZ,KAAK,CAAC;EACxB;AACF","ignoreList":[]}

package/lib/module/linking/DeferredLinkQueue.test.js

@@ -0,0 +1,54 @@
+"use strict";
+
+import { DeferredLinkQueue } from "./DeferredLinkQueue.js";
+describe('DeferredLinkQueue', () => {
+  let uut;
+  let flushed;
+  beforeEach(() => {
+    uut = new DeferredLinkQueue();
+    flushed = [];
+    uut.setFlushCallback(url => flushed.push(url));
+  });
+  it('starts not ready', () => {
+    expect(uut.isReady()).toBe(false);
+  });
+  it('enqueues URLs while not ready', () => {
+    uut.enqueue('myapp://a');
+    uut.enqueue('myapp://b');
+    expect(uut.pending()).toEqual(['myapp://a', 'myapp://b']);
+    expect(flushed).toEqual([]);
+  });
+  it('flushes queued URLs in order when becoming ready', () => {
+    uut.enqueue('myapp://a');
+    uut.enqueue('myapp://b');
+    uut.setReady(true);
+    expect(flushed).toEqual(['myapp://a', 'myapp://b']);
+    expect(uut.pending()).toEqual([]);
+  });
+  it('does not re-flush when already ready', () => {
+    uut.setReady(true);
+    uut.enqueue('myapp://a');
+    uut.setReady(true);
+    expect(flushed).toEqual([]);
+    expect(uut.pending()).toEqual(['myapp://a']);
+  });
+  it('flushes again after toggling not-ready → ready', () => {
+    uut.setReady(true);
+    uut.setReady(false);
+    uut.enqueue('myapp://x');
+    uut.setReady(true);
+    expect(flushed).toEqual(['myapp://x']);
+  });
+  it('clear() drops pending URLs', () => {
+    uut.enqueue('myapp://a');
+    uut.clear();
+    uut.setReady(true);
+    expect(flushed).toEqual([]);
+  });
+  it('flush() is a no-op when no callback is registered', () => {
+    const fresh = new DeferredLinkQueue();
+    fresh.enqueue('myapp://a');
+    expect(() => fresh.flush()).not.toThrow();
+  });
+});
+//# sourceMappingURL=DeferredLinkQueue.test.js.map

package/lib/module/linking/DeferredLinkQueue.test.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DeferredLinkQueue","describe","uut","flushed","beforeEach","setFlushCallback","url","push","it","expect","isReady","toBe","enqueue","pending","toEqual","setReady","clear","fresh","flush","not","toThrow"],"sourceRoot":"../../../src","sources":["linking/DeferredLinkQueue.test.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/linking/LinkingHandler.js

@@ -0,0 +1,139 @@
+"use strict";
+
+import { Linking } from 'react-native';
+import { URLParser } from "./URLParser.js";
+import { RouteMatcher } from "./RouteMatcher.js";
+import { DeferredLinkQueue } from "./DeferredLinkQueue.js";
+import { ModalLayoutBuilder } from "./ModalLayoutBuilder.js";
+
+/** A function that shows a layout as a modal. Mirrors `Commands.showModal`. */
+
+/**
+ * Minimal abstraction over React Native's `Linking` module so the handler
+ * can be tested without touching native bindings.
+ */
+
+/**
+ * Orchestrates deep linking:
+ *
+ *   1. Subscribes to URL events from `Linking` and the initial URL.
+ *   2. Parses + matches each URL against the configured `screens` tree.
+ *   3. Defers processing until both:
+ *        - the first `setRoot` has resolved (so a modal can be presented), and
+ *        - the user-supplied `isReady` predicate (if any) returns `true`.
+ *   4. Resolves matches in this order:
+ *        - `onLink(match)` if provided (full escape hatch), else
+ *        - `getModal(match)` if provided, else
+ *        - the default `ModalLayoutBuilder` output.
+ *      Result is presented via `showModal`.
+ *   5. Calls `fallback(url)` when a URL has no matching prefix or route.
+ */
+export class LinkingHandler {
+  config = null;
+  linkingSubscription = null;
+  rootReady = false;
+  userReadyOverride = null;
+  constructor(showModal, linkingAPI) {
+    this.urlParser = new URLParser();
+    this.routeMatcher = new RouteMatcher();
+    this.deferredQueue = new DeferredLinkQueue();
+    this.modalLayoutBuilder = new ModalLayoutBuilder();
+    this.showModal = showModal;
+    this.linkingAPI = linkingAPI || Linking;
+    this.deferredQueue.setFlushCallback(url => this.processURL(url));
+  }
+  configure(config) {
+    this.teardown();
+    this.config = config;
+    const tree = this.routeMatcher.buildRouteTree(config.config.screens);
+    this.routeMatcher.setRouteTree(tree);
+    this.refreshReady();
+    this.subscribe();
+  }
+
+  /**
+   * Manually feed a URL into the pipeline as if it came from the OS.
+   * Useful for URLs received from push notifications or other sources.
+   */
+  handleURL(url) {
+    if (!this.config) return;
+    if (!this.isReady()) {
+      this.deferredQueue.enqueue(url);
+      return;
+    }
+    this.processURL(url);
+  }
+
+  /**
+   * Called by `NavigationRoot` after the first `setRoot` resolves. Subsequent
+   * calls are no-ops.
+   */
+  setRootReady() {
+    if (this.rootReady) return;
+    this.rootReady = true;
+    this.refreshReady();
+  }
+
+  /**
+   * Public toggle for the app-supplied readiness gate. Overrides the
+   * `config.isReady` predicate from the moment it's first called.
+   */
+  setLinkingReady(ready) {
+    this.userReadyOverride = ready;
+    this.refreshReady();
+  }
+
+  /**
+   * Resolve a URL to a `RouteMatch` without side effects. Returns `null`
+   * when the URL doesn't match any configured prefix or route.
+   */
+  resolve(url) {
+    if (!this.config) return null;
+    const parsed = this.urlParser.parse(url, this.config.prefixes);
+    if (!parsed) return null;
+    return this.routeMatcher.match(parsed.path, url, parsed.queryParams);
+  }
+  teardown() {
+    if (this.linkingSubscription) {
+      this.linkingSubscription.remove();
+      this.linkingSubscription = null;
+    }
+    this.deferredQueue.clear();
+    this.config = null;
+    this.userReadyOverride = null;
+  }
+  subscribe() {
+    this.linkingSubscription = this.linkingAPI.addEventListener('url', event => {
+      this.handleURL(event.url);
+    });
+    this.linkingAPI.getInitialURL().then(url => {
+      if (url) this.handleURL(url);
+    });
+  }
+  processURL(url) {
+    if (!this.config) return;
+    const match = this.resolve(url);
+    if (!match) {
+      this.config.fallback?.(url);
+      return;
+    }
+    if (this.config.onLink) {
+      this.config.onLink(match);
+      return;
+    }
+    const layout = this.config.getModal ? this.config.getModal(match) : this.modalLayoutBuilder.build(match);
+    if (layout) {
+      this.showModal(layout);
+    }
+  }
+  isReady() {
+    if (!this.rootReady) return false;
+    if (this.userReadyOverride !== null) return this.userReadyOverride;
+    if (this.config?.isReady) return this.config.isReady();
+    return true;
+  }
+  refreshReady() {
+    this.deferredQueue.setReady(this.isReady());
+  }
+}
+//# sourceMappingURL=LinkingHandler.js.map

package/lib/module/linking/LinkingHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Linking","URLParser","RouteMatcher","DeferredLinkQueue","ModalLayoutBuilder","LinkingHandler","config","linkingSubscription","rootReady","userReadyOverride","constructor","showModal","linkingAPI","urlParser","routeMatcher","deferredQueue","modalLayoutBuilder","setFlushCallback","url","processURL","configure","teardown","tree","buildRouteTree","screens","setRouteTree","refreshReady","subscribe","handleURL","isReady","enqueue","setRootReady","setLinkingReady","ready","resolve","parsed","parse","prefixes","match","path","queryParams","remove","clear","addEventListener","event","getInitialURL","then","fallback","onLink","layout","getModal","build","setReady"],"sourceRoot":"../../../src","sources":["linking/LinkingHandler.ts"],"mappings":"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","ignoreList":[]}