react-native-navigation 8.8.6 → 8.8.7

package/lib/module/linking/ModalLayoutBuilder.js

@@ -0,0 +1,56 @@
+"use strict";
+
+/**
+ * Props that React treats specially and must never be forwarded as
+ * regular component props. If a URL contains query parameters or path
+ * parameters using these names, they are dropped from `passProps`
+ * (with a dev-mode warning) to avoid crashing the screen.
+ */
+const RESERVED_PROP_NAMES = new Set(['ref', 'key']);
+
+/**
+ * Builds the default modal layout for a matched deep link.
+ *
+ * Behavior:
+ *   - Wraps the matched chain in a `stack`. Even a single-component match
+ *     gets wrapped so the screen has a topBar where the user can mount a
+ *     close button via `topBar.leftButtons`.
+ *   - Each segment becomes a `component` child of the stack, in match order.
+ *     The first segment is the root of the stack; subsequent segments are
+ *     pushed on top.
+ *   - Path params for each segment are merged with query params and passed
+ *     as `passProps` to that segment's component. Path params win on key
+ *     collision. React-reserved keys (`ref`, `key`) are filtered out.
+ */
+export class ModalLayoutBuilder {
+  build(match) {
+    return {
+      stack: {
+        children: match.path.map(segment => ({
+          component: {
+            name: segment.screen,
+            passProps: this.mergeProps(segment, match.queryParams)
+          }
+        }))
+      }
+    };
+  }
+  mergeProps(segment, queryParams) {
+    const merged = {
+      ...queryParams,
+      ...segment.params
+    };
+    const safe = {};
+    for (const key of Object.keys(merged)) {
+      if (RESERVED_PROP_NAMES.has(key)) {
+        if (__DEV__) {
+          console.warn(`[RNN linking] Dropping reserved prop "${key}" from passProps for screen "${segment.screen}". ` + `Rename the URL parameter to avoid conflicting with React-reserved names.`);
+        }
+        continue;
+      }
+      safe[key] = merged[key];
+    }
+    return safe;
+  }
+}
+//# sourceMappingURL=ModalLayoutBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["RESERVED_PROP_NAMES","Set","ModalLayoutBuilder","build","match","stack","children","path","map","segment","component","name","screen","passProps","mergeProps","queryParams","merged","params","safe","key","Object","keys","has","__DEV__","console","warn"],"sourceRoot":"../../../src","sources":["linking/ModalLayoutBuilder.ts"],"mappings":";;AAGA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMA,mBAAmB,GAAG,IAAIC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;;AAEnD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,kBAAkB,CAAC;EACvBC,KAAKA,CAACC,KAAiB,EAAU;IACtC,OAAO;MACLC,KAAK,EAAE;QACLC,QAAQ,EAAEF,KAAK,CAACG,IAAI,CAACC,GAAG,CAAEC,OAAO,KAAM;UACrCC,SAAS,EAAE;YACTC,IAAI,EAAEF,OAAO,CAACG,MAAM;YACpBC,SAAS,EAAE,IAAI,CAACC,UAAU,CAACL,OAAO,EAAEL,KAAK,CAACW,WAAW;UACvD;QACF,CAAC,CAAC;MACJ;IACF,CAAC;EACH;EAEQD,UAAUA,CAChBL,OAA0B,EAC1BM,WAAmC,EACX;IACxB,MAAMC,MAA8B,GAAG;MAAE,GAAGD,WAAW;MAAE,GAAGN,OAAO,CAACQ;IAAO,CAAC;IAC5E,MAAMC,IAA4B,GAAG,CAAC,CAAC;IACvC,KAAK,MAAMC,GAAG,IAAIC,MAAM,CAACC,IAAI,CAACL,MAAM,CAAC,EAAE;MACrC,IAAIhB,mBAAmB,CAACsB,GAAG,CAACH,GAAG,CAAC,EAAE;QAChC,IAAII,OAAO,EAAE;UACXC,OAAO,CAACC,IAAI,CACV,yCAAyCN,GAAG,gCAAgCV,OAAO,CAACG,MAAM,KAAK,GAC7F,0EACJ,CAAC;QACH;QACA;MACF;MACAM,IAAI,CAACC,GAAG,CAAC,GAAGH,MAAM,CAACG,GAAG,CAAC;IACzB;IACA,OAAOD,IAAI;EACb;AACF","ignoreList":[]}

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

@@ -0,0 +1,154 @@
+"use strict";
+
+import { ModalLayoutBuilder } from "./ModalLayoutBuilder.js";
+describe('ModalLayoutBuilder', () => {
+  let uut;
+  beforeEach(() => {
+    uut = new ModalLayoutBuilder();
+  });
+  it('wraps a single-segment match in a stack', () => {
+    const layout = uut.build({
+      url: 'myapp://home',
+      path: [{
+        screen: 'Home',
+        params: {}
+      }],
+      queryParams: {}
+    });
+    expect(layout).toEqual({
+      stack: {
+        children: [{
+          component: {
+            name: 'Home',
+            passProps: {}
+          }
+        }]
+      }
+    });
+  });
+  it('builds a push chain for multi-segment matches', () => {
+    const layout = uut.build({
+      url: 'myapp://settings/notifications',
+      path: [{
+        screen: 'Settings',
+        params: {}
+      }, {
+        screen: 'Notifications',
+        params: {}
+      }],
+      queryParams: {}
+    });
+    expect(layout.stack?.children).toEqual([{
+      component: {
+        name: 'Settings',
+        passProps: {}
+      }
+    }, {
+      component: {
+        name: 'Notifications',
+        passProps: {}
+      }
+    }]);
+  });
+  it('passes path params as passProps', () => {
+    const layout = uut.build({
+      url: 'myapp://user/42',
+      path: [{
+        screen: 'Profile',
+        params: {
+          id: '42'
+        }
+      }],
+      queryParams: {}
+    });
+    expect(layout.stack?.children?.[0].component?.passProps).toEqual({
+      id: '42'
+    });
+  });
+  it('merges query params into every segment, with path params taking precedence', () => {
+    const layout = uut.build({
+      url: 'myapp://user/42?id=99&source=push',
+      path: [{
+        screen: 'Profile',
+        params: {
+          id: '42'
+        }
+      }],
+      queryParams: {
+        id: '99',
+        source: 'push'
+      }
+    });
+    expect(layout.stack?.children?.[0].component?.passProps).toEqual({
+      id: '42',
+      source: 'push'
+    });
+  });
+  it('applies query params to every segment of a nested match', () => {
+    const layout = uut.build({
+      url: 'myapp://settings/notifications?source=push',
+      path: [{
+        screen: 'Settings',
+        params: {}
+      }, {
+        screen: 'Notifications',
+        params: {}
+      }],
+      queryParams: {
+        source: 'push'
+      }
+    });
+    expect(layout.stack?.children?.[0].component?.passProps).toEqual({
+      source: 'push'
+    });
+    expect(layout.stack?.children?.[1].component?.passProps).toEqual({
+      source: 'push'
+    });
+  });
+  it('filters the React-reserved "ref" query param from passProps', () => {
+    const layout = uut.build({
+      url: 'myapp://user/42?ref=notification&utm=push',
+      path: [{
+        screen: 'Profile',
+        params: {
+          id: '42'
+        }
+      }],
+      queryParams: {
+        ref: 'notification',
+        utm: 'push'
+      }
+    });
+    expect(layout.stack?.children?.[0].component?.passProps).toEqual({
+      id: '42',
+      utm: 'push'
+    });
+  });
+  it('filters the React-reserved "key" query param from passProps', () => {
+    const layout = uut.build({
+      url: 'myapp://home?key=abc',
+      path: [{
+        screen: 'Home',
+        params: {}
+      }],
+      queryParams: {
+        key: 'abc'
+      }
+    });
+    expect(layout.stack?.children?.[0].component?.passProps).toEqual({});
+  });
+  it('filters reserved keys when they appear as path params too', () => {
+    const layout = uut.build({
+      url: 'myapp://r/abc',
+      path: [{
+        screen: 'Home',
+        params: {
+          ref: 'abc'
+        }
+      }],
+      queryParams: {}
+    });
+    expect(layout.stack?.children?.[0].component?.passProps).toEqual({});
+  });
+});
+//# sourceMappingURL=ModalLayoutBuilder.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["ModalLayoutBuilder","describe","uut","beforeEach","it","layout","build","url","path","screen","params","queryParams","expect","toEqual","stack","children","component","name","passProps","id","source","ref","utm","key"],"sourceRoot":"../../../src","sources":["linking/ModalLayoutBuilder.test.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,yBAAsB;AAEzDC,QAAQ,CAAC,oBAAoB,EAAE,MAAM;EACnC,IAAIC,GAAuB;EAE3BC,UAAU,CAAC,MAAM;IACfD,GAAG,GAAG,IAAIF,kBAAkB,CAAC,CAAC;EAChC,CAAC,CAAC;EAEFI,EAAE,CAAC,yCAAyC,EAAE,MAAM;IAClD,MAAMC,MAAM,GAAGH,GAAG,CAACI,KAAK,CAAC;MACvBC,GAAG,EAAE,cAAc;MACnBC,IAAI,EAAE,CAAC;QAAEC,MAAM,EAAE,MAAM;QAAEC,MAAM,EAAE,CAAC;MAAE,CAAC,CAAC;MACtCC,WAAW,EAAE,CAAC;IAChB,CAAC,CAAC;IACFC,MAAM,CAACP,MAAM,CAAC,CAACQ,OAAO,CAAC;MACrBC,KAAK,EAAE;QACLC,QAAQ,EAAE,CACR;UACEC,SAAS,EAAE;YAAEC,IAAI,EAAE,MAAM;YAAEC,SAAS,EAAE,CAAC;UAAE;QAC3C,CAAC;MAEL;IACF,CAAC,CAAC;EACJ,CAAC,CAAC;EAEFd,EAAE,CAAC,+CAA+C,EAAE,MAAM;IACxD,MAAMC,MAAM,GAAGH,GAAG,CAACI,KAAK,CAAC;MACvBC,GAAG,EAAE,gCAAgC;MACrCC,IAAI,EAAE,CACJ;QAAEC,MAAM,EAAE,UAAU;QAAEC,MAAM,EAAE,CAAC;MAAE,CAAC,EAClC;QAAED,MAAM,EAAE,eAAe;QAAEC,MAAM,EAAE,CAAC;MAAE,CAAC,CACxC;MACDC,WAAW,EAAE,CAAC;IAChB,CAAC,CAAC;IACFC,MAAM,CAACP,MAAM,CAACS,KAAK,EAAEC,QAAQ,CAAC,CAACF,OAAO,CAAC,CACrC;MAAEG,SAAS,EAAE;QAAEC,IAAI,EAAE,UAAU;QAAEC,SAAS,EAAE,CAAC;MAAE;IAAE,CAAC,EAClD;MAAEF,SAAS,EAAE;QAAEC,IAAI,EAAE,eAAe;QAAEC,SAAS,EAAE,CAAC;MAAE;IAAE,CAAC,CACxD,CAAC;EACJ,CAAC,CAAC;EAEFd,EAAE,CAAC,iCAAiC,EAAE,MAAM;IAC1C,MAAMC,MAAM,GAAGH,GAAG,CAACI,KAAK,CAAC;MACvBC,GAAG,EAAE,iBAAiB;MACtBC,IAAI,EAAE,CAAC;QAAEC,MAAM,EAAE,SAAS;QAAEC,MAAM,EAAE;UAAES,EAAE,EAAE;QAAK;MAAE,CAAC,CAAC;MACnDR,WAAW,EAAE,CAAC;IAChB,CAAC,CAAC;IACFC,MAAM,CAACP,MAAM,CAACS,KAAK,EAAEC,QAAQ,GAAG,CAAC,CAAC,CAACC,SAAS,EAAEE,SAAS,CAAC,CAACL,OAAO,CAAC;MAAEM,EAAE,EAAE;IAAK,CAAC,CAAC;EAChF,CAAC,CAAC;EAEFf,EAAE,CAAC,4EAA4E,EAAE,MAAM;IACrF,MAAMC,MAAM,GAAGH,GAAG,CAACI,KAAK,CAAC;MACvBC,GAAG,EAAE,mCAAmC;MACxCC,IAAI,EAAE,CAAC;QAAEC,MAAM,EAAE,SAAS;QAAEC,MAAM,EAAE;UAAES,EAAE,EAAE;QAAK;MAAE,CAAC,CAAC;MACnDR,WAAW,EAAE;QAAEQ,EAAE,EAAE,IAAI;QAAEC,MAAM,EAAE;MAAO;IAC1C,CAAC,CAAC;IACFR,MAAM,CAACP,MAAM,CAACS,KAAK,EAAEC,QAAQ,GAAG,CAAC,CAAC,CAACC,SAAS,EAAEE,SAAS,CAAC,CAACL,OAAO,CAAC;MAC/DM,EAAE,EAAE,IAAI;MACRC,MAAM,EAAE;IACV,CAAC,CAAC;EACJ,CAAC,CAAC;EAEFhB,EAAE,CAAC,yDAAyD,EAAE,MAAM;IAClE,MAAMC,MAAM,GAAGH,GAAG,CAACI,KAAK,CAAC;MACvBC,GAAG,EAAE,4CAA4C;MACjDC,IAAI,EAAE,CACJ;QAAEC,MAAM,EAAE,UAAU;QAAEC,MAAM,EAAE,CAAC;MAAE,CAAC,EAClC;QAAED,MAAM,EAAE,eAAe;QAAEC,MAAM,EAAE,CAAC;MAAE,CAAC,CACxC;MACDC,WAAW,EAAE;QAAES,MAAM,EAAE;MAAO;IAChC,CAAC,CAAC;IACFR,MAAM,CAACP,MAAM,CAACS,KAAK,EAAEC,QAAQ,GAAG,CAAC,CAAC,CAACC,SAAS,EAAEE,SAAS,CAAC,CAACL,OAAO,CAAC;MAAEO,MAAM,EAAE;IAAO,CAAC,CAAC;IACpFR,MAAM,CAACP,MAAM,CAACS,KAAK,EAAEC,QAAQ,GAAG,CAAC,CAAC,CAACC,SAAS,EAAEE,SAAS,CAAC,CAACL,OAAO,CAAC;MAAEO,MAAM,EAAE;IAAO,CAAC,CAAC;EACtF,CAAC,CAAC;EAEFhB,EAAE,CAAC,6DAA6D,EAAE,MAAM;IACtE,MAAMC,MAAM,GAAGH,GAAG,CAACI,KAAK,CAAC;MACvBC,GAAG,EAAE,2CAA2C;MAChDC,IAAI,EAAE,CAAC;QAAEC,MAAM,EAAE,SAAS;QAAEC,MAAM,EAAE;UAAES,EAAE,EAAE;QAAK;MAAE,CAAC,CAAC;MACnDR,WAAW,EAAE;QAAEU,GAAG,EAAE,cAAc;QAAEC,GAAG,EAAE;MAAO;IAClD,CAAC,CAAC;IACFV,MAAM,CAACP,MAAM,CAACS,KAAK,EAAEC,QAAQ,GAAG,CAAC,CAAC,CAACC,SAAS,EAAEE,SAAS,CAAC,CAACL,OAAO,CAAC;MAC/DM,EAAE,EAAE,IAAI;MACRG,GAAG,EAAE;IACP,CAAC,CAAC;EACJ,CAAC,CAAC;EAEFlB,EAAE,CAAC,6DAA6D,EAAE,MAAM;IACtE,MAAMC,MAAM,GAAGH,GAAG,CAACI,KAAK,CAAC;MACvBC,GAAG,EAAE,sBAAsB;MAC3BC,IAAI,EAAE,CAAC;QAAEC,MAAM,EAAE,MAAM;QAAEC,MAAM,EAAE,CAAC;MAAE,CAAC,CAAC;MACtCC,WAAW,EAAE;QAAEY,GAAG,EAAE;MAAM;IAC5B,CAAC,CAAC;IACFX,MAAM,CAACP,MAAM,CAACS,KAAK,EAAEC,QAAQ,GAAG,CAAC,CAAC,CAACC,SAAS,EAAEE,SAAS,CAAC,CAACL,OAAO,CAAC,CAAC,CAAC,CAAC;EACtE,CAAC,CAAC;EAEFT,EAAE,CAAC,2DAA2D,EAAE,MAAM;IACpE,MAAMC,MAAM,GAAGH,GAAG,CAACI,KAAK,CAAC;MACvBC,GAAG,EAAE,eAAe;MACpBC,IAAI,EAAE,CAAC;QAAEC,MAAM,EAAE,MAAM;QAAEC,MAAM,EAAE;UAAEW,GAAG,EAAE;QAAM;MAAE,CAAC,CAAC;MAClDV,WAAW,EAAE,CAAC;IAChB,CAAC,CAAC;IACFC,MAAM,CAACP,MAAM,CAACS,KAAK,EAAEC,QAAQ,GAAG,CAAC,CAAC,CAACC,SAAS,EAAEE,SAAS,CAAC,CAACL,OAAO,CAAC,CAAC,CAAC,CAAC;EACtE,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/lib/module/linking/RouteMatcher.js

@@ -0,0 +1,104 @@
+"use strict";
+
+/**
+ * Compiles a `screens` config into a tree of `RouteNode`s and resolves
+ * parsed paths to a matched `RouteMatch`.
+ *
+ * Matching is depth-first, in insertion order. The first node whose pattern
+ * (and nested children) consume the entire path wins.
+ */
+export class RouteMatcher {
+  routeTree = null;
+  buildRouteTree(screens) {
+    const nodes = [];
+    for (const [screenName, config] of Object.entries(screens)) {
+      nodes.push(this.buildNode(screenName, config));
+    }
+    return nodes;
+  }
+  setRouteTree(tree) {
+    this.routeTree = tree;
+  }
+
+  /**
+   * Match a parsed path (e.g. `"user/42"`) against the configured tree.
+   * Returns the matched chain or `null` when no route matches.
+   */
+  match(path, url, queryParams) {
+    if (!this.routeTree) return null;
+    const pathSegments = path.split('/').filter(s => s.length > 0);
+    const result = this.matchRecursive(pathSegments, 0, this.routeTree);
+    if (!result) return null;
+    return {
+      url,
+      path: result,
+      queryParams
+    };
+  }
+  buildNode(screenName, config) {
+    if (typeof config === 'string') {
+      return {
+        screen: screenName,
+        pattern: config,
+        segments: this.splitPattern(config),
+        children: []
+      };
+    }
+    const children = config.screens ? this.buildRouteTree(config.screens) : [];
+    return {
+      screen: screenName,
+      pattern: config.path ?? null,
+      segments: config.path ? this.splitPattern(config.path) : [],
+      children
+    };
+  }
+  splitPattern(pattern) {
+    return pattern.split('/').filter(s => s.length > 0);
+  }
+  matchRecursive(pathSegments, offset, nodes) {
+    for (const node of nodes) {
+      const result = this.tryMatchNode(pathSegments, offset, node);
+      if (result) return result;
+    }
+    return null;
+  }
+  tryMatchNode(pathSegments, offset, node) {
+    if (node.pattern === null && node.segments.length === 0) {
+      if (node.children.length === 0) return null;
+      const childMatch = this.matchRecursive(pathSegments, offset, node.children);
+      if (!childMatch) return null;
+      return [{
+        screen: node.screen,
+        params: {}
+      }, ...childMatch];
+    }
+    const patternSegments = node.segments;
+    if (offset + patternSegments.length > pathSegments.length) {
+      return null;
+    }
+    const params = {};
+    for (let i = 0; i < patternSegments.length; i++) {
+      const pattern = patternSegments[i];
+      const actual = pathSegments[offset + i];
+      if (pattern.startsWith(':')) {
+        params[pattern.slice(1)] = actual;
+      } else if (pattern !== actual) {
+        return null;
+      }
+    }
+    const newOffset = offset + patternSegments.length;
+    const segment = {
+      screen: node.screen,
+      params
+    };
+    if (newOffset === pathSegments.length) {
+      return [segment];
+    }
+    if (node.children.length > 0) {
+      const childMatch = this.matchRecursive(pathSegments, newOffset, node.children);
+      if (childMatch) return [segment, ...childMatch];
+    }
+    return null;
+  }
+}
+//# sourceMappingURL=RouteMatcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["RouteMatcher","routeTree","buildRouteTree","screens","nodes","screenName","config","Object","entries","push","buildNode","setRouteTree","tree","match","path","url","queryParams","pathSegments","split","filter","s","length","result","matchRecursive","screen","pattern","segments","splitPattern","children","offset","node","tryMatchNode","childMatch","params","patternSegments","i","actual","startsWith","slice","newOffset","segment"],"sourceRoot":"../../../src","sources":["linking/RouteMatcher.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,164 @@
+"use strict";
+
+import { RouteMatcher } from "./RouteMatcher.js";
+describe('RouteMatcher', () => {
+  let uut;
+  beforeEach(() => {
+    uut = new RouteMatcher();
+  });
+  function configure(screens) {
+    uut.setRouteTree(uut.buildRouteTree(screens));
+  }
+  it('matches a flat route', () => {
+    configure({
+      Home: 'home'
+    });
+    expect(uut.match('home', 'myapp://home', {})).toEqual({
+      url: 'myapp://home',
+      path: [{
+        screen: 'Home',
+        params: {}
+      }],
+      queryParams: {}
+    });
+  });
+  it('extracts a single path parameter', () => {
+    configure({
+      Profile: 'user/:id'
+    });
+    expect(uut.match('user/42', 'myapp://user/42', {})).toEqual({
+      url: 'myapp://user/42',
+      path: [{
+        screen: 'Profile',
+        params: {
+          id: '42'
+        }
+      }],
+      queryParams: {}
+    });
+  });
+  it('extracts multiple path parameters', () => {
+    configure({
+      Post: 'user/:userId/post/:postId'
+    });
+    const result = uut.match('user/5/post/99', 'myapp://user/5/post/99', {});
+    expect(result?.path[0].params).toEqual({
+      userId: '5',
+      postId: '99'
+    });
+  });
+  it('returns null when no route matches', () => {
+    configure({
+      Home: 'home'
+    });
+    expect(uut.match('unknown', 'myapp://unknown', {})).toBeNull();
+  });
+  it('returns null when path is longer than any pattern', () => {
+    configure({
+      Home: 'home'
+    });
+    expect(uut.match('home/extra', 'myapp://home/extra', {})).toBeNull();
+  });
+  it('matches the first registered route on ambiguity', () => {
+    configure({
+      Profile: 'user/:id',
+      User: 'user/:userId'
+    });
+    const result = uut.match('user/42', 'myapp://user/42', {});
+    expect(result?.path[0].screen).toBe('Profile');
+  });
+  it('matches a nested route as a chain', () => {
+    configure({
+      Settings: {
+        path: 'settings',
+        screens: {
+          Notifications: 'notifications'
+        }
+      }
+    });
+    expect(uut.match('settings/notifications', 'myapp://settings/notifications', {})).toEqual({
+      url: 'myapp://settings/notifications',
+      path: [{
+        screen: 'Settings',
+        params: {}
+      }, {
+        screen: 'Notifications',
+        params: {}
+      }],
+      queryParams: {}
+    });
+  });
+  it('matches a parent-only nested route', () => {
+    configure({
+      Settings: {
+        path: 'settings',
+        screens: {
+          Notifications: 'notifications'
+        }
+      }
+    });
+    expect(uut.match('settings', 'myapp://settings', {})).toEqual({
+      url: 'myapp://settings',
+      path: [{
+        screen: 'Settings',
+        params: {}
+      }],
+      queryParams: {}
+    });
+  });
+  it('supports grouping nodes that consume no segments', () => {
+    configure({
+      Main: {
+        screens: {
+          Feed: 'feed',
+          Search: 'search'
+        }
+      }
+    });
+    const result = uut.match('feed', 'myapp://feed', {});
+    expect(result?.path).toEqual([{
+      screen: 'Main',
+      params: {}
+    }, {
+      screen: 'Feed',
+      params: {}
+    }]);
+  });
+  it('passes query params through to the match result', () => {
+    configure({
+      Home: 'home'
+    });
+    const result = uut.match('home', 'myapp://home?ref=push', {
+      ref: 'push'
+    });
+    expect(result?.queryParams).toEqual({
+      ref: 'push'
+    });
+  });
+  it('returns null when no route tree has been configured', () => {
+    expect(uut.match('home', 'myapp://home', {})).toBeNull();
+  });
+  it('matches nested params at multiple levels', () => {
+    configure({
+      Org: {
+        path: 'org/:orgId',
+        screens: {
+          Project: 'project/:projectId'
+        }
+      }
+    });
+    const result = uut.match('org/1/project/2', 'myapp://org/1/project/2', {});
+    expect(result?.path).toEqual([{
+      screen: 'Org',
+      params: {
+        orgId: '1'
+      }
+    }, {
+      screen: 'Project',
+      params: {
+        projectId: '2'
+      }
+    }]);
+  });
+});
+//# sourceMappingURL=RouteMatcher.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["RouteMatcher","describe","uut","beforeEach","configure","screens","setRouteTree","buildRouteTree","it","Home","expect","match","toEqual","url","path","screen","params","queryParams","Profile","id","Post","result","userId","postId","toBeNull","User","toBe","Settings","Notifications","Main","Feed","Search","ref","Org","Project","orgId","projectId"],"sourceRoot":"../../../src","sources":["linking/RouteMatcher.test.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/linking/URLParser.js

@@ -0,0 +1,56 @@
+"use strict";
+
+/**
+ * Parses a URL string against a list of configured prefixes.
+ *
+ * Responsibilities:
+ *   - Strip the longest matching prefix (or report no match).
+ *   - Drop any `#fragment` portion.
+ *   - Decode each path segment so literal patterns compare against decoded
+ *     text (e.g. `hello%20world` matches a `hello world` pattern segment).
+ *   - Parse the query string into a plain key/value map.
+ */
+export class URLParser {
+  stripPrefix(url, prefixes) {
+    const sorted = [...prefixes].sort((a, b) => b.length - a.length);
+    for (const prefix of sorted) {
+      if (url.startsWith(prefix)) {
+        return url.slice(prefix.length);
+      }
+    }
+    return null;
+  }
+  parse(url, prefixes) {
+    const stripped = this.stripPrefix(url, prefixes);
+    if (stripped === null) {
+      return null;
+    }
+    const withoutFragment = stripped.split('#', 1)[0];
+    const [pathPart, queryPart] = withoutFragment.split('?', 2);
+    const path = pathPart.split('/').filter(s => s.length > 0).map(segment => safeDecode(segment)).join('/');
+    const queryParams = {};
+    if (queryPart) {
+      for (const pair of queryPart.split('&')) {
+        if (!pair) continue;
+        const eqIndex = pair.indexOf('=');
+        const rawKey = eqIndex === -1 ? pair : pair.slice(0, eqIndex);
+        const rawValue = eqIndex === -1 ? '' : pair.slice(eqIndex + 1);
+        const key = safeDecode(rawKey);
+        if (!key) continue;
+        queryParams[key] = safeDecode(rawValue);
+      }
+    }
+    return {
+      path,
+      queryParams
+    };
+  }
+}
+function safeDecode(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+//# sourceMappingURL=URLParser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["URLParser","stripPrefix","url","prefixes","sorted","sort","a","b","length","prefix","startsWith","slice","parse","stripped","withoutFragment","split","pathPart","queryPart","path","filter","s","map","segment","safeDecode","join","queryParams","pair","eqIndex","indexOf","rawKey","rawValue","key","value","decodeURIComponent"],"sourceRoot":"../../../src","sources":["linking/URLParser.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,SAAS,CAAC;EACdC,WAAWA,CAACC,GAAW,EAAEC,QAAkB,EAAiB;IACjE,MAAMC,MAAM,GAAG,CAAC,GAAGD,QAAQ,CAAC,CAACE,IAAI,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKA,CAAC,CAACC,MAAM,GAAGF,CAAC,CAACE,MAAM,CAAC;IAChE,KAAK,MAAMC,MAAM,IAAIL,MAAM,EAAE;MAC3B,IAAIF,GAAG,CAACQ,UAAU,CAACD,MAAM,CAAC,EAAE;QAC1B,OAAOP,GAAG,CAACS,KAAK,CAACF,MAAM,CAACD,MAAM,CAAC;MACjC;IACF;IACA,OAAO,IAAI;EACb;EAEOI,KAAKA,CAACV,GAAW,EAAEC,QAAkB,EAAoB;IAC9D,MAAMU,QAAQ,GAAG,IAAI,CAACZ,WAAW,CAACC,GAAG,EAAEC,QAAQ,CAAC;IAChD,IAAIU,QAAQ,KAAK,IAAI,EAAE;MACrB,OAAO,IAAI;IACb;IAEA,MAAMC,eAAe,GAAGD,QAAQ,CAACE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,CAACC,QAAQ,EAAEC,SAAS,CAAC,GAAGH,eAAe,CAACC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAE3D,MAAMG,IAAI,GAAGF,QAAQ,CAClBD,KAAK,CAAC,GAAG,CAAC,CACVI,MAAM,CAAEC,CAAC,IAAKA,CAAC,CAACZ,MAAM,GAAG,CAAC,CAAC,CAC3Ba,GAAG,CAAEC,OAAO,IAAKC,UAAU,CAACD,OAAO,CAAC,CAAC,CACrCE,IAAI,CAAC,GAAG,CAAC;IAEZ,MAAMC,WAAmC,GAAG,CAAC,CAAC;IAC9C,IAAIR,SAAS,EAAE;MACb,KAAK,MAAMS,IAAI,IAAIT,SAAS,CAACF,KAAK,CAAC,GAAG,CAAC,EAAE;QACvC,IAAI,CAACW,IAAI,EAAE;QACX,MAAMC,OAAO,GAAGD,IAAI,CAACE,OAAO,CAAC,GAAG,CAAC;QACjC,MAAMC,MAAM,GAAGF,OAAO,KAAK,CAAC,CAAC,GAAGD,IAAI,GAAGA,IAAI,CAACf,KAAK,CAAC,CAAC,EAAEgB,OAAO,CAAC;QAC7D,MAAMG,QAAQ,GAAGH,OAAO,KAAK,CAAC,CAAC,GAAG,EAAE,GAAGD,IAAI,CAACf,KAAK,CAACgB,OAAO,GAAG,CAAC,CAAC;QAC9D,MAAMI,GAAG,GAAGR,UAAU,CAACM,MAAM,CAAC;QAC9B,IAAI,CAACE,GAAG,EAAE;QACVN,WAAW,CAACM,GAAG,CAAC,GAAGR,UAAU,CAACO,QAAQ,CAAC;MACzC;IACF;IAEA,OAAO;MAAEZ,IAAI;MAAEO;IAAY,CAAC;EAC9B;AACF;AAEA,SAASF,UAAUA,CAACS,KAAa,EAAU;EACzC,IAAI;IACF,OAAOC,kBAAkB,CAACD,KAAK,CAAC;EAClC,CAAC,CAAC,MAAM;IACN,OAAOA,KAAK;EACd;AACF","ignoreList":[]}

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

@@ -0,0 +1,100 @@
+"use strict";
+
+import { URLParser } from "./URLParser.js";
+describe('URLParser', () => {
+  let uut;
+  beforeEach(() => {
+    uut = new URLParser();
+  });
+  describe('stripPrefix', () => {
+    it('returns the remainder after the matching prefix', () => {
+      expect(uut.stripPrefix('myapp://home', ['myapp://'])).toBe('home');
+    });
+    it('returns null when no prefix matches', () => {
+      expect(uut.stripPrefix('other://home', ['myapp://'])).toBeNull();
+    });
+    it('chooses the longest matching prefix', () => {
+      const result = uut.stripPrefix('https://myapp.com/v2/home', ['https://myapp.com', 'https://myapp.com/v2']);
+      expect(result).toBe('/home');
+    });
+  });
+  describe('parse', () => {
+    const prefixes = ['myapp://', 'https://myapp.com'];
+    it('returns null when no prefix matches', () => {
+      expect(uut.parse('other://home', prefixes)).toBeNull();
+    });
+    it('parses a simple path', () => {
+      expect(uut.parse('myapp://home', prefixes)).toEqual({
+        path: 'home',
+        queryParams: {}
+      });
+    });
+    it('trims leading and trailing slashes', () => {
+      expect(uut.parse('myapp:///home/', prefixes)).toEqual({
+        path: 'home',
+        queryParams: {}
+      });
+    });
+    it('parses query parameters', () => {
+      expect(uut.parse('myapp://search?q=hello&page=2', prefixes)).toEqual({
+        path: 'search',
+        queryParams: {
+          q: 'hello',
+          page: '2'
+        }
+      });
+    });
+    it('decodes URL-encoded path segments', () => {
+      expect(uut.parse('myapp://hello%20world', prefixes)).toEqual({
+        path: 'hello world',
+        queryParams: {}
+      });
+    });
+    it('decodes URL-encoded query parameter keys and values', () => {
+      expect(uut.parse('myapp://search?q=hello%20world&a%20b=c', prefixes)).toEqual({
+        path: 'search',
+        queryParams: {
+          q: 'hello world',
+          'a b': 'c'
+        }
+      });
+    });
+    it('strips fragments before parsing the query', () => {
+      expect(uut.parse('myapp://home?x=1#section', prefixes)).toEqual({
+        path: 'home',
+        queryParams: {
+          x: '1'
+        }
+      });
+    });
+    it('strips fragments when there is no query string', () => {
+      expect(uut.parse('myapp://home#section', prefixes)).toEqual({
+        path: 'home',
+        queryParams: {}
+      });
+    });
+    it('treats query keys without values as empty strings', () => {
+      expect(uut.parse('myapp://home?flag', prefixes)).toEqual({
+        path: 'home',
+        queryParams: {
+          flag: ''
+        }
+      });
+    });
+    it('handles malformed encoding without throwing', () => {
+      expect(uut.parse('myapp://%E0%A4%A', prefixes)).toEqual({
+        path: '%E0%A4%A',
+        queryParams: {}
+      });
+    });
+    it('keeps "=" inside values intact', () => {
+      expect(uut.parse('myapp://search?token=a=b=c', prefixes)).toEqual({
+        path: 'search',
+        queryParams: {
+          token: 'a=b=c'
+        }
+      });
+    });
+  });
+});
+//# sourceMappingURL=URLParser.test.js.map