one 1.2.83 → 1.2.84

package/dist/cjs/router/linkingConfig.cjs

@@ -26,7 +26,8 @@ __export(linkingConfig_exports, {
   setupLinking: () => setupLinking
 });
 module.exports = __toCommonJS(linkingConfig_exports);
-var import_getLinkingConfig = require("./getLinkingConfig.cjs");
+var import_getLinkingConfig = require("./getLinkingConfig.cjs"),
+  import_routeMask = require("./routeMask.cjs");
 let linkingConfig;
 function getLinking() {
   return linkingConfig;
@@ -39,5 +40,15 @@ function resetLinking() {
 }
 function setupLinking(routeNode, initialLocation) {
   let initialState;
-  return routeNode && (linkingConfig = (0, import_getLinkingConfig.getLinkingConfig)(routeNode), initialLocation && (linkingConfig.getInitialURL = () => initialLocation.toString(), initialState = linkingConfig.getStateFromPath?.(initialLocation.pathname + (initialLocation.search || ""), linkingConfig.config))), initialState;
+  if (routeNode && (linkingConfig = (0, import_getLinkingConfig.getLinkingConfig)(routeNode), initialLocation)) {
+    linkingConfig.getInitialURL = () => initialLocation.toString();
+    let path = initialLocation.pathname + (initialLocation.search || "");
+    const unmaskPath = (0, import_routeMask.parseUnmaskFromPath)(initialLocation.pathname);
+    if (unmaskPath) path = unmaskPath;else if (typeof window < "u") {
+      const historyState = window.history.state;
+      historyState?.__tempLocation?.pathname && !historyState.__tempKey && (path = historyState.__tempLocation.pathname + (historyState.__tempLocation.search || ""));
+    }
+    initialState = linkingConfig.getStateFromPath?.(path, linkingConfig.config);
+  }
+  return initialState;
 }

package/dist/cjs/router/linkingConfig.js

@@ -20,7 +20,7 @@ __export(linkingConfig_exports, {
   setupLinking: () => setupLinking
 });
 module.exports = __toCommonJS(linkingConfig_exports);
-var import_getLinkingConfig = require("./getLinkingConfig");
+var import_getLinkingConfig = require("./getLinkingConfig"), import_routeMask = require("./routeMask");
 let linkingConfig;
 function getLinking() {
   return linkingConfig;
@@ -33,9 +33,18 @@ function resetLinking() {
 }
 function setupLinking(routeNode, initialLocation) {
   let initialState;
-  return routeNode && (linkingConfig = (0, import_getLinkingConfig.getLinkingConfig)(routeNode), initialLocation && (linkingConfig.getInitialURL = () => initialLocation.toString(), initialState = linkingConfig.getStateFromPath?.(
-    initialLocation.pathname + (initialLocation.search || ""),
-    linkingConfig.config
-  ))), initialState;
+  if (routeNode && (linkingConfig = (0, import_getLinkingConfig.getLinkingConfig)(routeNode), initialLocation)) {
+    linkingConfig.getInitialURL = () => initialLocation.toString();
+    let path = initialLocation.pathname + (initialLocation.search || "");
+    const unmaskPath = (0, import_routeMask.parseUnmaskFromPath)(initialLocation.pathname);
+    if (unmaskPath)
+      path = unmaskPath;
+    else if (typeof window < "u") {
+      const historyState = window.history.state;
+      historyState?.__tempLocation?.pathname && !historyState.__tempKey && (path = historyState.__tempLocation.pathname + (historyState.__tempLocation.search || ""));
+    }
+    initialState = linkingConfig.getStateFromPath?.(path, linkingConfig.config);
+  }
+  return initialState;
 }
 //# sourceMappingURL=linkingConfig.js.map

package/dist/cjs/router/linkingConfig.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/router/linkingConfig.ts"],
-  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,8BAGO;AAGP,IAAI;AAEG,SAAS,aAAa;AAC3B,SAAO;AACT;AAEO,SAAS,WAAW,GAAsB;AAC/C,kBAAgB;AAClB;AAEO,SAAS,eAAe;AAC7B,kBAAgB;AAClB;AAEO,SAAS,aACd,WACA,iBACmC;AACnC,MAAI;AAEJ,SAAI,cACF,oBAAgB,wBAAAA,kBAAoB,SAAS,GAEzC,oBACF,cAAc,gBAAgB,MAAM,gBAAgB,SAAS,GAC7D,eAAe,cAAc;AAAA,IAC3B,gBAAgB,YAAY,gBAAgB,UAAU;AAAA,IACtD,cAAc;AAAA,EAChB,KAIG;AACT;",
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,8BAGO,+BAEP,mBAAoC;AAEpC,IAAI;AAEG,SAAS,aAAa;AAC3B,SAAO;AACT;AAEO,SAAS,WAAW,GAAsB;AAC/C,kBAAgB;AAClB;AAEO,SAAS,eAAe;AAC7B,kBAAgB;AAClB;AAEO,SAAS,aACd,WACA,iBACmC;AACnC,MAAI;AAEJ,MAAI,cACF,oBAAgB,wBAAAA,kBAAoB,SAAS,GAEzC,kBAAiB;AACnB,kBAAc,gBAAgB,MAAM,gBAAgB,SAAS;AAI7D,QAAI,OAAO,gBAAgB,YAAY,gBAAgB,UAAU;AAIjE,UAAM,iBAAa,sCAAoB,gBAAgB,QAAQ;AAC/D,QAAI;AACF,aAAO;AAAA,aACE,OAAO,SAAW,KAAa;AAExC,YAAM,eAAe,OAAO,QAAQ;AACpC,MAAI,cAAc,gBAAgB,YAAY,CAAC,aAAa,cAE1D,OAAO,aAAa,eAAe,YAAY,aAAa,eAAe,UAAU;AAAA,IAEzF;AAEA,mBAAe,cAAc,mBAAmB,MAAM,cAAc,MAAM;AAAA,EAC5E;AAGF,SAAO;AACT;",
   "names": ["createLinkingConfig"]
 }

package/dist/cjs/router/linkingConfig.native.js

@@ -29,6 +29,7 @@ __export(linkingConfig_exports, {
 });
 module.exports = __toCommonJS(linkingConfig_exports);
 var import_getLinkingConfig = require("./getLinkingConfig.native.js"),
+  import_routeMask = require("./routeMask.native.js"),
   linkingConfig;
 function getLinking() {
   return linkingConfig;
@@ -45,7 +46,15 @@ function setupLinking(routeNode, initialLocation) {
     var _linkingConfig_getStateFromPath;
     linkingConfig.getInitialURL = function () {
       return initialLocation.toString();
-    }, initialState = (_linkingConfig_getStateFromPath = linkingConfig.getStateFromPath) === null || _linkingConfig_getStateFromPath === void 0 ? void 0 : _linkingConfig_getStateFromPath.call(linkingConfig, initialLocation.pathname + (initialLocation.search || ""), linkingConfig.config);
+    };
+    var path = initialLocation.pathname + (initialLocation.search || ""),
+      unmaskPath = (0, import_routeMask.parseUnmaskFromPath)(initialLocation.pathname);
+    if (unmaskPath) path = unmaskPath;else if (typeof window < "u") {
+      var _historyState___tempLocation,
+        historyState = window.history.state;
+      !(historyState == null || (_historyState___tempLocation = historyState.__tempLocation) === null || _historyState___tempLocation === void 0) && _historyState___tempLocation.pathname && !historyState.__tempKey && (path = historyState.__tempLocation.pathname + (historyState.__tempLocation.search || ""));
+    }
+    initialState = (_linkingConfig_getStateFromPath = linkingConfig.getStateFromPath) === null || _linkingConfig_getStateFromPath === void 0 ? void 0 : _linkingConfig_getStateFromPath.call(linkingConfig, path, linkingConfig.config);
   }
   return initialState;
 }

package/dist/cjs/router/linkingConfig.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","linkingConfig_exports","__export","getLinking","resetLinking","setLinking","setupLinking","module","exports","import_getLinkingConfig","require","linkingConfig","_","routeNode","initialLocation","initialState","getLinkingConfig","_linkingConfig_getStateFromPath","getInitialURL","toString","getStateFromPath","call","pathname","search","config"],"sources":["../../../src/router/linkingConfig.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,qBAAA;AAAAC,QAAA,CAAAD,qBAAA;EAAAE,UAAA,EAAAA,CAAA,KAAAA,UAAA;EAAAC,YAAA,EAAAA,CAAA,KAAAA,YAAA;EAAAC,UAAA,EAAAA,CAAA,KAAAA,UAAA;EAAAC,YAAA,EAAAA,CAAA,KAAAA;AAAA;AACAC,MAAA,CAAAC,OAAA,GAAAZ,YAAA,CAGOK,qBAAA;AAGP,IAAIQ,uBAAA,GAAAC,OAAA;EAAAC,aAAA;AAEG,SAASR,WAAA,EAAa;EAC3B,OAAOQ,aAAA;AACT;AAEO,SAASN,WAAWO,CAAA,EAAsB;EAC/CD,aAAA,GAAgBC,CAAA;AAClB;AAEO,SAASR,aAAA,EAAe;EAC7BO,aAAA,GAAgB;AAClB;AAEO,SAASL,aACdO,SAAA,EACAC,eAAA,EACmC;EACnC,IAAIC,YAAA;EAEJ,IAAAF,SAAI,KAAAF,aACF,OAAAF,uBAAgB,CAAAO,gBAAA,EAAAH,SAAoB,GAASC,eAEzC;IAGA,IAAAG,+BAA4B;IAC5BN,aAAA,CAAcO,aAAA;MAChB,OAIGJ,eAAA,CAAAK,QAAA;IACT,GAAAJ,YAAA,IAAAE,+BAAA,GAAAN,aAAA,CAAAS,gBAAA,cAAAH,+BAAA,uBAAAA,+BAAA,CAAAI,IAAA,CAAAV,aAAA,EAAAG,eAAA,CAAAQ,QAAA,IAAAR,eAAA,CAAAS,MAAA,SAAAZ,aAAA,CAAAa,MAAA","ignoreList":[]}
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","linkingConfig_exports","__export","getLinking","resetLinking","setLinking","setupLinking","module","exports","import_getLinkingConfig","require","import_routeMask","linkingConfig","_","routeNode","initialLocation","initialState","getLinkingConfig","_linkingConfig_getStateFromPath","getInitialURL","toString","path","pathname","search","unmaskPath","parseUnmaskFromPath","window","_historyState___tempLocation","historyState","history","state","__tempLocation","__tempKey","getStateFromPath","call","config"],"sources":["../../../src/router/linkingConfig.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,qBAAA;AAAAC,QAAA,CAAAD,qBAAA;EAAAE,UAAA,EAAAA,CAAA,KAAAA,UAAA;EAAAC,YAAA,EAAAA,CAAA,KAAAA,YAAA;EAAAC,UAAA,EAAAA,CAAA,KAAAA,UAAA;EAAAC,YAAA,EAAAA,CAAA,KAAAA;AAAA;AACAC,MAAA,CAAAC,OAAA,GAAAZ,YAAA,CAGOK,qBAAA;AAIP,IAAIQ,uBAAA,GAAAC,OAAA;EAAAC,gBAAA,GAAAD,OAAA;EAAAE,aAAA;AAEG,SAAST,WAAA,EAAa;EAC3B,OAAOS,aAAA;AACT;AAEO,SAASP,WAAWQ,CAAA,EAAsB;EAC/CD,aAAA,GAAgBC,CAAA;AAClB;AAEO,SAAST,aAAA,EAAe;EAC7BQ,aAAA,GAAgB;AAClB;AAEO,SAASN,aACdQ,SAAA,EACAC,eAAA,EACmC;EACnC,IAAIC,YAAA;EAEJ,IAAIF,SAAA,KACFF,aAAA,OAAgBH,uBAAA,CAAAQ,gBAAA,EAAoBH,SAAS,GAEzCC,eAAA,GAAiB;IACnB,IAAAG,+BAA8B;IAI9BN,aAAW,CAAAO,aAAgB,eAAY;MAIvC,OAAMJ,eAAa,CAAAK,QAAA;IACnB;IACE,IAAAC,IAAA,GAAON,eAAA,CAAAO,QAAA,IAAAP,eAAA,CAAAQ,MAAA;MAAAC,UAAA,OAAAb,gBAAA,CAAAc,mBAAA,EAAAV,eAAA,CAAAO,QAAA;IAAA,IAAAE,UACE,EAETH,IAAA,GAAMG,UAAA,MACF,WAAcE,MAAA;MAIpB,IAAAC,4BAAA;QAAAC,YAAA,GAAAF,MAAA,CAAAG,OAAA,CAAAC,KAAA;MAEA,EAAAF,YAAe,aAAcD,4BAAyB,GAAAC,YAAc,CAAAG,cAAM,cAAAJ,4BAAA,gBAAAA,4BAAA,CAAAL,QAAA,KAAAM,YAAA,CAAAI,SAAA,KAAAX,IAAA,GAAAO,YAAA,CAAAG,cAAA,CAAAT,QAAA,IAAAM,YAAA,CAAAG,cAAA,CAAAR,MAAA;IAC5E;IAGFP,YAAO,IAAAE,+BAAA,GAAAN,aAAA,CAAAqB,gBAAA,cAAAf,+BAAA,uBAAAA,+BAAA,CAAAgB,IAAA,CAAAtB,aAAA,EAAAS,IAAA,EAAAT,aAAA,CAAAuB,MAAA;EACT","ignoreList":[]}

package/dist/cjs/router/routeMask.cjs

@@ -0,0 +1,137 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+    for (var name in all) __defProp(target, name, {
+      get: all[name],
+      enumerable: !0
+    });
+  },
+  __copyProps = (to, from, except, desc) => {
+    if (from && typeof from == "object" || typeof from == "function") for (let key of __getOwnPropNames(from)) !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+    return to;
+  };
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: !0
+}), mod);
+var routeMask_exports = {};
+__export(routeMask_exports, {
+  buildMaskedPath: () => buildMaskedPath,
+  createRouteMask: () => createRouteMask,
+  decodeUnmask: () => decodeUnmask,
+  encodeUnmask: () => encodeUnmask,
+  findMatchingMask: () => findMatchingMask,
+  matchRouteMask: () => matchRouteMask,
+  parseUnmaskFromPath: () => parseUnmaskFromPath
+});
+module.exports = __toCommonJS(routeMask_exports);
+function createRouteMask(options) {
+  const {
+      from,
+      to,
+      params = !0,
+      unmaskOnReload = !1,
+      useSearchParam = !1
+    } = options,
+    fromParams = [],
+    fromRegexStr = from.split("/").map(segment => {
+      if (segment.startsWith("[...") && segment.endsWith("]")) {
+        const paramName = segment.slice(4, -1);
+        return fromParams.push(paramName), "(.+)";
+      }
+      if (segment.startsWith("$...")) {
+        const paramName = segment.slice(4);
+        return fromParams.push(paramName), "(.+)";
+      }
+      if (segment.startsWith("[") && segment.endsWith("]")) {
+        const paramName = segment.slice(1, -1);
+        return fromParams.push(paramName), "([^/]+)";
+      }
+      if (segment.startsWith("$")) {
+        const paramName = segment.slice(1);
+        return fromParams.push(paramName), "([^/]+)";
+      }
+      return segment.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    }).join("/");
+  return {
+    from,
+    to,
+    params,
+    unmaskOnReload,
+    useSearchParam,
+    _fromRegex: new RegExp(`^${fromRegexStr}$`),
+    _fromParams: fromParams
+  };
+}
+function matchRouteMask(pathname, mask) {
+  const match = pathname.match(mask._fromRegex);
+  if (!match) return null;
+  const params = {};
+  return mask._fromParams.forEach((paramName, index) => {
+    params[paramName] = match[index + 1];
+  }), params;
+}
+function buildMaskedPath(mask, matchedParams) {
+  let params;
+  return mask.params === !1 ? params = {} : typeof mask.params == "function" ? params = mask.params(matchedParams) : params = matchedParams, mask.to.split("/").map(segment => {
+    if (segment.startsWith("[...") && segment.endsWith("]")) {
+      const paramName = segment.slice(4, -1);
+      return params[paramName] ?? "";
+    }
+    if (segment.startsWith("$...")) {
+      const paramName = segment.slice(4);
+      return params[paramName] ?? "";
+    }
+    if (segment.startsWith("[") && segment.endsWith("]")) {
+      const paramName = segment.slice(1, -1);
+      return params[paramName] ?? "";
+    }
+    if (segment.startsWith("$")) {
+      const paramName = segment.slice(1);
+      return params[paramName] ?? "";
+    }
+    return segment;
+  }).join("/");
+}
+function encodeUnmask(path) {
+  return btoa(path).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function decodeUnmask(encoded) {
+  const base64 = encoded.replace(/-/g, "+").replace(/_/g, "/");
+  return atob(base64);
+}
+const UNMASK_SEPARATOR = "__";
+function parseUnmaskFromPath(pathname) {
+  const lastSlash = pathname.lastIndexOf("/"),
+    lastSegment = pathname.slice(lastSlash + 1),
+    separatorIndex = lastSegment.indexOf(UNMASK_SEPARATOR);
+  if (separatorIndex === -1) return null;
+  const encoded = lastSegment.slice(separatorIndex + UNMASK_SEPARATOR.length);
+  if (!encoded) return null;
+  try {
+    return decodeUnmask(encoded);
+  } catch {
+    return null;
+  }
+}
+function findMatchingMask(pathname, routeMasks) {
+  for (const mask of routeMasks) {
+    const matchedParams = matchRouteMask(pathname, mask);
+    if (matchedParams) {
+      const maskedPath = buildMaskedPath(mask, matchedParams),
+        useSearchParam = mask.useSearchParam ?? !1;
+      return {
+        // If useSearchParam is true, append base64-encoded actual path as pathname postfix
+        // e.g. /photos/3__L3Bob3Rvcy8zL21vZGFs
+        maskedPath: useSearchParam ? `${maskedPath}${UNMASK_SEPARATOR}${encodeUnmask(pathname)}` : maskedPath,
+        unmaskOnReload: mask.unmaskOnReload ?? !1,
+        useSearchParam,
+        actualPath: pathname
+      };
+    }
+  }
+}

package/dist/cjs/router/routeMask.js

@@ -0,0 +1,127 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: !0 });
+}, __copyProps = (to, from, except, desc) => {
+  if (from && typeof from == "object" || typeof from == "function")
+    for (let key of __getOwnPropNames(from))
+      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
+var routeMask_exports = {};
+__export(routeMask_exports, {
+  buildMaskedPath: () => buildMaskedPath,
+  createRouteMask: () => createRouteMask,
+  decodeUnmask: () => decodeUnmask,
+  encodeUnmask: () => encodeUnmask,
+  findMatchingMask: () => findMatchingMask,
+  matchRouteMask: () => matchRouteMask,
+  parseUnmaskFromPath: () => parseUnmaskFromPath
+});
+module.exports = __toCommonJS(routeMask_exports);
+function createRouteMask(options) {
+  const {
+    from,
+    to,
+    params = !0,
+    unmaskOnReload = !1,
+    useSearchParam = !1
+  } = options, fromParams = [], fromRegexStr = from.split("/").map((segment) => {
+    if (segment.startsWith("[...") && segment.endsWith("]")) {
+      const paramName = segment.slice(4, -1);
+      return fromParams.push(paramName), "(.+)";
+    }
+    if (segment.startsWith("$...")) {
+      const paramName = segment.slice(4);
+      return fromParams.push(paramName), "(.+)";
+    }
+    if (segment.startsWith("[") && segment.endsWith("]")) {
+      const paramName = segment.slice(1, -1);
+      return fromParams.push(paramName), "([^/]+)";
+    }
+    if (segment.startsWith("$")) {
+      const paramName = segment.slice(1);
+      return fromParams.push(paramName), "([^/]+)";
+    }
+    return segment.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  }).join("/");
+  return {
+    from,
+    to,
+    params,
+    unmaskOnReload,
+    useSearchParam,
+    _fromRegex: new RegExp(`^${fromRegexStr}$`),
+    _fromParams: fromParams
+  };
+}
+function matchRouteMask(pathname, mask) {
+  const match = pathname.match(mask._fromRegex);
+  if (!match) return null;
+  const params = {};
+  return mask._fromParams.forEach((paramName, index) => {
+    params[paramName] = match[index + 1];
+  }), params;
+}
+function buildMaskedPath(mask, matchedParams) {
+  let params;
+  return mask.params === !1 ? params = {} : typeof mask.params == "function" ? params = mask.params(matchedParams) : params = matchedParams, mask.to.split("/").map((segment) => {
+    if (segment.startsWith("[...") && segment.endsWith("]")) {
+      const paramName = segment.slice(4, -1);
+      return params[paramName] ?? "";
+    }
+    if (segment.startsWith("$...")) {
+      const paramName = segment.slice(4);
+      return params[paramName] ?? "";
+    }
+    if (segment.startsWith("[") && segment.endsWith("]")) {
+      const paramName = segment.slice(1, -1);
+      return params[paramName] ?? "";
+    }
+    if (segment.startsWith("$")) {
+      const paramName = segment.slice(1);
+      return params[paramName] ?? "";
+    }
+    return segment;
+  }).join("/");
+}
+function encodeUnmask(path) {
+  return btoa(path).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function decodeUnmask(encoded) {
+  const base64 = encoded.replace(/-/g, "+").replace(/_/g, "/");
+  return atob(base64);
+}
+const UNMASK_SEPARATOR = "__";
+function parseUnmaskFromPath(pathname) {
+  const lastSlash = pathname.lastIndexOf("/"), lastSegment = pathname.slice(lastSlash + 1), separatorIndex = lastSegment.indexOf(UNMASK_SEPARATOR);
+  if (separatorIndex === -1) return null;
+  const encoded = lastSegment.slice(separatorIndex + UNMASK_SEPARATOR.length);
+  if (!encoded) return null;
+  try {
+    return decodeUnmask(encoded);
+  } catch {
+    return null;
+  }
+}
+function findMatchingMask(pathname, routeMasks) {
+  for (const mask of routeMasks) {
+    const matchedParams = matchRouteMask(pathname, mask);
+    if (matchedParams) {
+      const maskedPath = buildMaskedPath(mask, matchedParams), useSearchParam = mask.useSearchParam ?? !1;
+      return {
+        // If useSearchParam is true, append base64-encoded actual path as pathname postfix
+        // e.g. /photos/3__L3Bob3Rvcy8zL21vZGFs
+        maskedPath: useSearchParam ? `${maskedPath}${UNMASK_SEPARATOR}${encodeUnmask(pathname)}` : maskedPath,
+        unmaskOnReload: mask.unmaskOnReload ?? !1,
+        useSearchParam,
+        actualPath: pathname
+      };
+    }
+  }
+}
+//# sourceMappingURL=routeMask.js.map

package/dist/cjs/router/routeMask.js.map

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

package/dist/cjs/router/routeMask.native.js

@@ -0,0 +1,160 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+    for (var name in all) __defProp(target, name, {
+      get: all[name],
+      enumerable: !0
+    });
+  },
+  __copyProps = (to, from, except, desc) => {
+    if (from && typeof from == "object" || typeof from == "function") for (let key of __getOwnPropNames(from)) !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+    return to;
+  };
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: !0
+}), mod);
+var routeMask_exports = {};
+__export(routeMask_exports, {
+  buildMaskedPath: () => buildMaskedPath,
+  createRouteMask: () => createRouteMask,
+  decodeUnmask: () => decodeUnmask,
+  encodeUnmask: () => encodeUnmask,
+  findMatchingMask: () => findMatchingMask,
+  matchRouteMask: () => matchRouteMask,
+  parseUnmaskFromPath: () => parseUnmaskFromPath
+});
+module.exports = __toCommonJS(routeMask_exports);
+function createRouteMask(options) {
+  var {
+      from,
+      to,
+      params = !0,
+      unmaskOnReload = !1,
+      useSearchParam = !1
+    } = options,
+    fromParams = [],
+    fromRegexStr = from.split("/").map(function (segment) {
+      if (segment.startsWith("[...") && segment.endsWith("]")) {
+        var paramName = segment.slice(4, -1);
+        return fromParams.push(paramName), "(.+)";
+      }
+      if (segment.startsWith("$...")) {
+        var paramName1 = segment.slice(4);
+        return fromParams.push(paramName1), "(.+)";
+      }
+      if (segment.startsWith("[") && segment.endsWith("]")) {
+        var paramName2 = segment.slice(1, -1);
+        return fromParams.push(paramName2), "([^/]+)";
+      }
+      if (segment.startsWith("$")) {
+        var paramName3 = segment.slice(1);
+        return fromParams.push(paramName3), "([^/]+)";
+      }
+      return segment.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    }).join("/");
+  return {
+    from,
+    to,
+    params,
+    unmaskOnReload,
+    useSearchParam,
+    _fromRegex: new RegExp(`^${fromRegexStr}$`),
+    _fromParams: fromParams
+  };
+}
+function matchRouteMask(pathname, mask) {
+  var match = pathname.match(mask._fromRegex);
+  if (!match) return null;
+  var params = {};
+  return mask._fromParams.forEach(function (paramName, index) {
+    params[paramName] = match[index + 1];
+  }), params;
+}
+function buildMaskedPath(mask, matchedParams) {
+  var params;
+  return mask.params === !1 ? params = {} : typeof mask.params == "function" ? params = mask.params(matchedParams) : params = matchedParams, mask.to.split("/").map(function (segment) {
+    if (segment.startsWith("[...") && segment.endsWith("]")) {
+      var _params_paramName,
+        paramName = segment.slice(4, -1);
+      return (_params_paramName = params[paramName]) !== null && _params_paramName !== void 0 ? _params_paramName : "";
+    }
+    if (segment.startsWith("$...")) {
+      var _params_paramName1,
+        paramName1 = segment.slice(4);
+      return (_params_paramName1 = params[paramName1]) !== null && _params_paramName1 !== void 0 ? _params_paramName1 : "";
+    }
+    if (segment.startsWith("[") && segment.endsWith("]")) {
+      var _params_paramName2,
+        paramName2 = segment.slice(1, -1);
+      return (_params_paramName2 = params[paramName2]) !== null && _params_paramName2 !== void 0 ? _params_paramName2 : "";
+    }
+    if (segment.startsWith("$")) {
+      var _params_paramName3,
+        paramName3 = segment.slice(1);
+      return (_params_paramName3 = params[paramName3]) !== null && _params_paramName3 !== void 0 ? _params_paramName3 : "";
+    }
+    return segment;
+  }).join("/");
+}
+function encodeUnmask(path) {
+  return btoa(path).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function decodeUnmask(encoded) {
+  var base64 = encoded.replace(/-/g, "+").replace(/_/g, "/");
+  return atob(base64);
+}
+var UNMASK_SEPARATOR = "__";
+function parseUnmaskFromPath(pathname) {
+  var lastSlash = pathname.lastIndexOf("/"),
+    lastSegment = pathname.slice(lastSlash + 1),
+    separatorIndex = lastSegment.indexOf(UNMASK_SEPARATOR);
+  if (separatorIndex === -1) return null;
+  var encoded = lastSegment.slice(separatorIndex + UNMASK_SEPARATOR.length);
+  if (!encoded) return null;
+  try {
+    return decodeUnmask(encoded);
+  } catch {
+    return null;
+  }
+}
+function findMatchingMask(pathname, routeMasks) {
+  var _iteratorNormalCompletion = !0,
+    _didIteratorError = !1,
+    _iteratorError = void 0;
+  try {
+    for (var _iterator = routeMasks[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = !0) {
+      var mask = _step.value,
+        matchedParams = matchRouteMask(pathname, mask);
+      if (matchedParams) {
+        var _mask_useSearchParam,
+          _mask_unmaskOnReload,
+          maskedPath = buildMaskedPath(mask, matchedParams),
+          useSearchParam = (_mask_useSearchParam = mask.useSearchParam) !== null && _mask_useSearchParam !== void 0 ? _mask_useSearchParam : !1;
+        return {
+          // If useSearchParam is true, append base64-encoded actual path as pathname postfix
+          // e.g. /photos/3__L3Bob3Rvcy8zL21vZGFs
+          maskedPath: useSearchParam ? `${maskedPath}${UNMASK_SEPARATOR}${encodeUnmask(pathname)}` : maskedPath,
+          unmaskOnReload: (_mask_unmaskOnReload = mask.unmaskOnReload) !== null && _mask_unmaskOnReload !== void 0 ? _mask_unmaskOnReload : !1,
+          useSearchParam,
+          actualPath: pathname
+        };
+      }
+    }
+  } catch (err) {
+    _didIteratorError = !0, _iteratorError = err;
+  } finally {
+    try {
+      !_iteratorNormalCompletion && _iterator.return != null && _iterator.return();
+    } finally {
+      if (_didIteratorError) throw _iteratorError;
+    }
+  }
+}
+//# sourceMappingURL=routeMask.native.js.map

package/dist/cjs/router/routeMask.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","routeMask_exports","__export","buildMaskedPath","createRouteMask","decodeUnmask","encodeUnmask","findMatchingMask","matchRouteMask","parseUnmaskFromPath","module","exports","options","from","to","params","unmaskOnReload","useSearchParam","fromParams","fromRegexStr","split","map","segment","startsWith","endsWith","paramName","slice","push","paramName1","paramName2","paramName3","replace","join","_fromRegex","RegExp","_fromParams","pathname","mask","match","forEach","index","matchedParams","_params_paramName","_params_paramName1","_params_paramName2","_params_paramName3","path","btoa","encoded","base64","atob","UNMASK_SEPARATOR","lastSlash","lastIndexOf","lastSegment","separatorIndex","indexOf","length","routeMasks","_iteratorNormalCompletion","_didIteratorError","_iteratorError","_iterator","Symbol","iterator","_step","next","done","_mask_useSearchParam","_mask_unmaskOnReload","maskedPath","actualPath","err"],"sources":["../../../src/router/routeMask.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/cjs/router/router.cjs

@@ -26,6 +26,7 @@ __export(router_exports, {
   dismiss: () => dismiss,
   dismissAll: () => dismissAll,
   getPreloadHistory: () => getPreloadHistory,
+  getRouteMasks: () => getRouteMasks,
   getSortedRoutes: () => getSortedRoutes,
   getValidationState: () => getValidationState,
   goBack: () => goBack,
@@ -51,6 +52,7 @@ __export(router_exports, {
   routeNode: () => routeNode,
   setLoadingState: () => setLoadingState,
   setParams: () => setParams,
+  setRouteMasks: () => setRouteMasks,
   setValidationState: () => setValidationState,
   snapshot: () => snapshot,
   subscribeToLoadingState: () => subscribeToLoadingState,
@@ -87,9 +89,17 @@ var import_native = require("@react-navigation/native"),
   import_useScreens = require("./useScreens.cjs"),
   import_useViteRoutes = require("./useViteRoutes.cjs"),
   import_getNavigateAction = require("./utils/getNavigateAction.cjs"),
-  import_useMatches = require("../useMatches.cjs");
+  import_useMatches = require("../useMatches.cjs"),
+  import_routeMask = require("./routeMask.cjs");
 let routeNode = null,
-  rootComponent;
+  rootComponent,
+  routeMasks = [];
+function setRouteMasks(masks) {
+  routeMasks = masks;
+}
+function getRouteMasks() {
+  return routeMasks;
+}
 const protectedRouteRegistry = /* @__PURE__ */new Map();
 function registerProtectedRoutes(contextKey, protectedScreens) {
   protectedScreens.size === 0 ? protectedRouteRegistry.delete(contextKey) : protectedRouteRegistry.set(contextKey, protectedScreens);
@@ -545,7 +555,20 @@ async function linkTo(href, event, options) {
   currentMatches = newMatches, (0, import_useMatches.setClientMatches)(newMatches);
   const rootState2 = navigationRef.getRootState(),
     hash = href.indexOf("#");
-  rootState2.key && hash > 0 && (hashes[rootState2.key] = href.slice(hash)), nextOptions = options ?? null, (0, import_react.startTransition)(() => {
+  rootState2.key && hash > 0 && (hashes[rootState2.key] = href.slice(hash));
+  let finalOptions = options ?? null;
+  if (!finalOptions?.mask && routeMasks.length > 0) {
+    const pathname = (0, import_findRouteNode.extractPathnameFromHref)(href),
+      maskResult = (0, import_routeMask.findMatchingMask)(pathname, routeMasks);
+    maskResult && (finalOptions = {
+      ...finalOptions,
+      mask: {
+        href: maskResult.maskedPath,
+        unmaskOnReload: maskResult.unmaskOnReload
+      }
+    }, process.env.ONE_DEBUG_ROUTER && console.info(`[one] \u{1F3AD} Auto-masked ${pathname} \u2192 ${maskResult.maskedPath}`));
+  }
+  nextOptions = finalOptions, (0, import_react.startTransition)(() => {
     const action = (0, import_getNavigateAction.getNavigateAction)(state, rootState2, event),
       current2 = navigationRef.getCurrentRoute();
     navigationRef.dispatch(action);