expo-router 4.0.0-preview.9 → 4.0.0

package/build/typed-routes/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.regenerateDeclarations = exports.getWatchHandler = void 0;
+exports.regenerateDeclarations = exports.getWatchHandler = exports.version = void 0;
 const _ctx_shared_1 = require("expo-router/_ctx-shared");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -11,6 +11,11 @@ const generate_1 = require("./generate");
 const matchers_1 = require("../matchers");
 const require_context_ponyfill_1 = __importDefault(require("../testing-library/require-context-ponyfill"));
 const defaultCtx = (0, require_context_ponyfill_1.default)(process.env.EXPO_ROUTER_APP_ROOT, true, _ctx_shared_1.EXPO_ROUTER_CTX_IGNORE);
+/**
+ * This file is imported via `@expo/cli`. While users should be using the same SDK version of `expo-router` as `@expo/cli`,
+ * this export allows us to ensure that the version of the `expo-router` package is compatible with the version of `@expo/cli`.
+ */
+exports.version = 52;
 /**
  * Generate a Metro watch handler that regenerates the typed routes declaration file
  */
@@ -64,10 +69,10 @@ exports.getWatchHandler = getWatchHandler;
  *
  * If you process the types after the ADD, then they will crash as you will have conflicting routes
  */
-exports.regenerateDeclarations = debounce((outputDir, ctx = defaultCtx) => {
+exports.regenerateDeclarations = debounce((outputDir, options = {}, ctx = defaultCtx) => {
     // Don't crash the process, just log the error. The user will most likely fix it and continue
     try {
-        const file = (0, generate_1.getTypedRoutesDeclarationFile)(ctx);
+        const file = (0, generate_1.getTypedRoutesDeclarationFile)(ctx, options);
         if (!file)
             return;
         node_fs_1.default.writeFileSync(node_path_1.default.resolve(outputDir, './router.d.ts'), file);

package/build/typed-routes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/typed-routes/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { EXPO_ROUTER_CTX_IGNORE } from 'expo-router/_ctx-shared';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport { getTypedRoutesDeclarationFile } from './generate';\nimport { isTypedRoute } from '../matchers';\nimport requireContext, {\n  RequireContextPonyFill,\n} from '../testing-library/require-context-ponyfill';\n\nconst defaultCtx = requireContext(process.env.EXPO_ROUTER_APP_ROOT, true, EXPO_ROUTER_CTX_IGNORE);\n\nexport type { RequireContextPonyFill } from '../testing-library/require-context-ponyfill';\n\n/**\n * Generate a Metro watch handler that regenerates the typed routes declaration file\n */\nexport function getWatchHandler(\n  outputDir: string,\n  { ctx = defaultCtx, regenerateFn = regenerateDeclarations } = {} // Exposed for testing\n) {\n  const routeFiles = new Set(ctx.keys().filter((key) => isTypedRoute(key)));\n\n  return async function callback({ filePath, type }: { filePath: string; type: string }) {\n    // Sanity check that we are in an Expo Router project\n    if (!process.env.EXPO_ROUTER_APP_ROOT) return;\n\n    let shouldRegenerate = false;\n    let relativePath = path.relative(process.env.EXPO_ROUTER_APP_ROOT, filePath);\n    const isInsideAppRoot = !relativePath.startsWith('../');\n    const basename = path.basename(relativePath);\n\n    if (!isInsideAppRoot) return;\n\n    // require.context paths always start with './' when relative to the root\n    relativePath = `./${relativePath}`;\n\n    if (type === 'delete') {\n      ctx.__delete(relativePath);\n      if (routeFiles.has(relativePath)) {\n        routeFiles.delete(relativePath);\n        shouldRegenerate = true;\n      }\n    } else if (type === 'add') {\n      ctx.__add(relativePath);\n      if (isTypedRoute(basename)) {\n        routeFiles.add(relativePath);\n        shouldRegenerate = true;\n      }\n    } else {\n      shouldRegenerate = routeFiles.has(relativePath);\n    }\n\n    if (shouldRegenerate) {\n      regenerateFn(outputDir, ctx);\n    }\n  };\n}\n\n/**\n * Regenerate the declaration file.\n *\n * This function needs to be debounced due to Metro's handling of renaming folders.\n * For example, if you have the file /(tabs)/route.tsx and you rename the folder to /(tabs,test)/route.tsx\n *\n * Metro will fire 2 filesystem events:\n *  - ADD /(tabs,test)/router.tsx\n *  - DELETE /(tabs)/router.tsx\n *\n * If you process the types after the ADD, then they will crash as you will have conflicting routes\n */\nexport const regenerateDeclarations = debounce(\n  (outputDir: string, ctx: RequireContextPonyFill = defaultCtx) => {\n    // Don't crash the process, just log the error. The user will most likely fix it and continue\n    try {\n      const file = getTypedRoutesDeclarationFile(ctx);\n      if (!file) return;\n      fs.writeFileSync(path.resolve(outputDir, './router.d.ts'), file);\n    } catch (error) {\n      console.error(error);\n    }\n  }\n);\n\n/**\n * Debounce a function to only run once after a period of inactivity\n * If called while waiting, it will reset the timer\n */\nfunction debounce<T extends (...args: any[]) => any>(fn: T, timeout: number = 1000) {\n  let timer;\n  return (...args) => {\n    clearTimeout(timer);\n    timer = setTimeout(() => {\n      fn(...args);\n    }, timeout);\n  };\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/typed-routes/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { EXPO_ROUTER_CTX_IGNORE } from 'expo-router/_ctx-shared';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport { getTypedRoutesDeclarationFile } from './generate';\nimport { isTypedRoute } from '../matchers';\nimport requireContext, {\n  RequireContextPonyFill,\n} from '../testing-library/require-context-ponyfill';\n\nconst defaultCtx = requireContext(process.env.EXPO_ROUTER_APP_ROOT, true, EXPO_ROUTER_CTX_IGNORE);\n\nexport type { RequireContextPonyFill } from '../testing-library/require-context-ponyfill';\n\n/**\n * This file is imported via `@expo/cli`. While users should be using the same SDK version of `expo-router` as `@expo/cli`,\n * this export allows us to ensure that the version of the `expo-router` package is compatible with the version of `@expo/cli`.\n */\nexport const version = 52;\n\n/**\n * Generate a Metro watch handler that regenerates the typed routes declaration file\n */\nexport function getWatchHandler(\n  outputDir: string,\n  { ctx = defaultCtx, regenerateFn = regenerateDeclarations } = {} // Exposed for testing\n) {\n  const routeFiles = new Set(ctx.keys().filter((key) => isTypedRoute(key)));\n\n  return async function callback({ filePath, type }: { filePath: string; type: string }) {\n    // Sanity check that we are in an Expo Router project\n    if (!process.env.EXPO_ROUTER_APP_ROOT) return;\n\n    let shouldRegenerate = false;\n    let relativePath = path.relative(process.env.EXPO_ROUTER_APP_ROOT, filePath);\n    const isInsideAppRoot = !relativePath.startsWith('../');\n    const basename = path.basename(relativePath);\n\n    if (!isInsideAppRoot) return;\n\n    // require.context paths always start with './' when relative to the root\n    relativePath = `./${relativePath}`;\n\n    if (type === 'delete') {\n      ctx.__delete(relativePath);\n      if (routeFiles.has(relativePath)) {\n        routeFiles.delete(relativePath);\n        shouldRegenerate = true;\n      }\n    } else if (type === 'add') {\n      ctx.__add(relativePath);\n      if (isTypedRoute(basename)) {\n        routeFiles.add(relativePath);\n        shouldRegenerate = true;\n      }\n    } else {\n      shouldRegenerate = routeFiles.has(relativePath);\n    }\n\n    if (shouldRegenerate) {\n      regenerateFn(outputDir, ctx);\n    }\n  };\n}\n\n/**\n * Regenerate the declaration file.\n *\n * This function needs to be debounced due to Metro's handling of renaming folders.\n * For example, if you have the file /(tabs)/route.tsx and you rename the folder to /(tabs,test)/route.tsx\n *\n * Metro will fire 2 filesystem events:\n *  - ADD /(tabs,test)/router.tsx\n *  - DELETE /(tabs)/router.tsx\n *\n * If you process the types after the ADD, then they will crash as you will have conflicting routes\n */\nexport const regenerateDeclarations = debounce(\n  (\n    outputDir: string,\n    options: { partialTypedGroups?: boolean } = {},\n    ctx: RequireContextPonyFill = defaultCtx\n  ) => {\n    // Don't crash the process, just log the error. The user will most likely fix it and continue\n    try {\n      const file = getTypedRoutesDeclarationFile(ctx, options);\n      if (!file) return;\n      fs.writeFileSync(path.resolve(outputDir, './router.d.ts'), file);\n    } catch (error) {\n      console.error(error);\n    }\n  }\n);\n\n/**\n * Debounce a function to only run once after a period of inactivity\n * If called while waiting, it will reset the timer\n */\nfunction debounce<T extends (...args: any[]) => any>(fn: T, timeout: number = 1000) {\n  let timer;\n  return (...args) => {\n    clearTimeout(timer);\n    timer = setTimeout(() => {\n      fn(...args);\n    }, timeout);\n  };\n}\n"]}

package/build/typed-routes/testSetup.d.ts

@@ -1,2 +1,2 @@
-export default function (): Promise<void>;
+export {};
 //# sourceMappingURL=testSetup.d.ts.map

package/build/typed-routes/testSetup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testSetup.d.ts","sourceRoot":"","sources":["../../src/typed-routes/testSetup.ts"],"names":[],"mappings":"AAqBA,0CAUC"}
+{"version":3,"file":"testSetup.d.ts","sourceRoot":"","sources":["../../src/typed-routes/testSetup.ts"],"names":[],"mappings":""}

package/build/typed-routes/testSetup.js

@@ -5,25 +5,37 @@ const path_1 = require("path");
 const generate_1 = require("./generate");
 const context_stubs_1 = require("../testing-library/context-stubs");
 const fixtures = {
-    basic: {
-        '/apple': () => null,
-        '/banana': () => null,
-        '/colors/[color]': () => null,
-        '/animals/[...animal]': () => null,
-        '/mix/[fruit]/[color]/[...animals]': () => null,
-        '/(group)/static': () => null,
-        '/(group)/(a,b)/folder/index': () => null,
-        '/(group)/(a,b)/folder/[slug]': () => null,
-        '/(group)/(a,b)/folder/[...slug]': () => null,
-        '/(c)/folder/[slug]': () => null,
+    default: {
+        context: {
+            '/apple': () => null,
+            '/banana': () => null,
+            '/colors/[color]': () => null,
+            '/animals/[...animal]': () => null,
+            '/mix/[fruit]/[color]/[...animals]': () => null,
+            '/(group)/static': () => null,
+            '/(group)/(a,b)/folder/index': () => null,
+            '/(group)/(a,b)/folder/[slug]': () => null,
+            '/(group)/(a,b)/folder/[...slug]': () => null,
+            '/(c)/folder/[slug]': () => null,
+        },
+    },
+    partialGroups: {
+        options: { partialTypedGroups: true },
+        context: {
+            '/(group)/static': () => null,
+            '/(group)/(a,b)/folder/index': () => null,
+            '/(group)/(a,b)/folder/[slug]': () => null,
+            '/(group)/(a,b)/folder/[...slug]': () => null,
+        },
     },
 };
-async function default_1() {
-    await Promise.all(Object.entries(fixtures).map(async ([key, value]) => {
-        const template = (0, generate_1.getTypedRoutesDeclarationFile)((0, context_stubs_1.inMemoryContext)(value));
+module.exports = function () {
+    return Promise.all(Object.entries(fixtures).map(async ([key, value]) => {
+        const template = (0, generate_1.getTypedRoutesDeclarationFile)((0, context_stubs_1.inMemoryContext)(value.context), {
+            ...value.options,
+            testIgnoreComments: true,
+        });
         return (0, promises_1.writeFile)((0, path_1.join)(__dirname, '/__tests__/fixtures/', key + '.d.ts'), template);
     }));
-    console.log('done');
-}
-exports.default = default_1;
+};
 //# sourceMappingURL=testSetup.js.map

package/build/typed-routes/testSetup.js.map

@@ -1 +1 @@
-{"version":3,"file":"testSetup.js","sourceRoot":"","sources":["../../src/typed-routes/testSetup.ts"],"names":[],"mappings":";;AAAA,0CAAwC;AACxC,+BAA4B;AAE5B,yCAA2D;AAC3D,oEAAkF;AAElF,MAAM,QAAQ,GAAkC;IAC9C,KAAK,EAAE;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;QACpB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;QACrB,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;QAC7B,sBAAsB,EAAE,GAAG,EAAE,CAAC,IAAI;QAClC,mCAAmC,EAAE,GAAG,EAAE,CAAC,IAAI;QAC/C,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;QAC7B,6BAA6B,EAAE,GAAG,EAAE,CAAC,IAAI;QACzC,8BAA8B,EAAE,GAAG,EAAE,CAAC,IAAI;QAC1C,iCAAiC,EAAE,GAAG,EAAE,CAAC,IAAI;QAC7C,oBAAoB,EAAE,GAAG,EAAE,CAAC,IAAI;KACjC;CACF,CAAC;AAEa,KAAK;IAClB,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAClD,MAAM,QAAQ,GAAG,IAAA,wCAA6B,EAAC,IAAA,+BAAe,EAAC,KAAK,CAAC,CAAC,CAAC;QAEvE,OAAO,IAAA,oBAAS,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,sBAAsB,EAAE,GAAG,GAAG,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrF,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAVD,4BAUC","sourcesContent":["import { writeFile } from 'fs/promises';\nimport { join } from 'path';\n\nimport { getTypedRoutesDeclarationFile } from './generate';\nimport { inMemoryContext, MemoryContext } from '../testing-library/context-stubs';\n\nconst fixtures: Record<string, MemoryContext> = {\n  basic: {\n    '/apple': () => null,\n    '/banana': () => null,\n    '/colors/[color]': () => null,\n    '/animals/[...animal]': () => null,\n    '/mix/[fruit]/[color]/[...animals]': () => null,\n    '/(group)/static': () => null,\n    '/(group)/(a,b)/folder/index': () => null,\n    '/(group)/(a,b)/folder/[slug]': () => null,\n    '/(group)/(a,b)/folder/[...slug]': () => null,\n    '/(c)/folder/[slug]': () => null,\n  },\n};\n\nexport default async function () {\n  await Promise.all(\n    Object.entries(fixtures).map(async ([key, value]) => {\n      const template = getTypedRoutesDeclarationFile(inMemoryContext(value));\n\n      return writeFile(join(__dirname, '/__tests__/fixtures/', key + '.d.ts'), template);\n    })\n  );\n\n  console.log('done');\n}\n"]}
+{"version":3,"file":"testSetup.js","sourceRoot":"","sources":["../../src/typed-routes/testSetup.ts"],"names":[],"mappings":";;AAAA,0CAAwC;AACxC,+BAA4B;AAE5B,yCAAiG;AACjG,oEAAkF;AAElF,MAAM,QAAQ,GAGV;IACF,OAAO,EAAE;QACP,OAAO,EAAE;YACP,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;YACpB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;YACrB,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;YAC7B,sBAAsB,EAAE,GAAG,EAAE,CAAC,IAAI;YAClC,mCAAmC,EAAE,GAAG,EAAE,CAAC,IAAI;YAC/C,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;YAC7B,6BAA6B,EAAE,GAAG,EAAE,CAAC,IAAI;YACzC,8BAA8B,EAAE,GAAG,EAAE,CAAC,IAAI;YAC1C,iCAAiC,EAAE,GAAG,EAAE,CAAC,IAAI;YAC7C,oBAAoB,EAAE,GAAG,EAAE,CAAC,IAAI;SACjC;KACF;IACD,aAAa,EAAE;QACb,OAAO,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE;QACrC,OAAO,EAAE;YACP,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;YAC7B,6BAA6B,EAAE,GAAG,EAAE,CAAC,IAAI;YACzC,8BAA8B,EAAE,GAAG,EAAE,CAAC,IAAI;YAC1C,iCAAiC,EAAE,GAAG,EAAE,CAAC,IAAI;SAC9C;KACF;CACF,CAAC;AAEF,MAAM,CAAC,OAAO,GAAG;IACf,OAAO,OAAO,CAAC,GAAG,CAChB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAClD,MAAM,QAAQ,GAAG,IAAA,wCAA6B,EAAC,IAAA,+BAAe,EAAC,KAAK,CAAC,OAAO,CAAC,EAAE;YAC7E,GAAG,KAAK,CAAC,OAAO;YAChB,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;QAEH,OAAO,IAAA,oBAAS,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,sBAAsB,EAAE,GAAG,GAAG,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrF,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import { writeFile } from 'fs/promises';\nimport { join } from 'path';\n\nimport { getTypedRoutesDeclarationFile, GetTypedRoutesDeclarationFileOptions } from './generate';\nimport { inMemoryContext, MemoryContext } from '../testing-library/context-stubs';\n\nconst fixtures: Record<\n  string,\n  { context: MemoryContext; options?: GetTypedRoutesDeclarationFileOptions }\n> = {\n  default: {\n    context: {\n      '/apple': () => null,\n      '/banana': () => null,\n      '/colors/[color]': () => null,\n      '/animals/[...animal]': () => null,\n      '/mix/[fruit]/[color]/[...animals]': () => null,\n      '/(group)/static': () => null,\n      '/(group)/(a,b)/folder/index': () => null,\n      '/(group)/(a,b)/folder/[slug]': () => null,\n      '/(group)/(a,b)/folder/[...slug]': () => null,\n      '/(c)/folder/[slug]': () => null,\n    },\n  },\n  partialGroups: {\n    options: { partialTypedGroups: true },\n    context: {\n      '/(group)/static': () => null,\n      '/(group)/(a,b)/folder/index': () => null,\n      '/(group)/(a,b)/folder/[slug]': () => null,\n      '/(group)/(a,b)/folder/[...slug]': () => null,\n    },\n  },\n};\n\nmodule.exports = function () {\n  return Promise.all(\n    Object.entries(fixtures).map(async ([key, value]) => {\n      const template = getTypedRoutesDeclarationFile(inMemoryContext(value.context), {\n        ...value.options,\n        testIgnoreComments: true,\n      });\n\n      return writeFile(join(__dirname, '/__tests__/fixtures/', key + '.d.ts'), template);\n    })\n  );\n};\n"]}

package/build/typed-routes/types.d.ts

@@ -1,27 +1,3 @@
-/**
- * @hidden
- */
-type HasTypedRoutes = ExpoRouter.__routes extends {
-    StaticRoutes: string;
-} ? true : false;
-/**
- * @hidden
- */
-export type StaticRoutes = ExpoRouter.__routes extends {
-    StaticRoutes: string;
-} ? ExpoRouter.__routes['StaticRoutes'] : string;
-/**
- * @hidden
- */
-export type DynamicRoutes<T extends string> = ExpoRouter.__routes<T> extends {
-    DynamicRoutes: any;
-} ? T extends ExpoRouter.__routes<infer _>['DynamicRoutes'] ? T : never : string;
-/**
- * @hidden
- */
-export type DynamicRouteTemplate = ExpoRouter.__routes extends {
-    DynamicRouteTemplate: string;
-} ? ExpoRouter.__routes['DynamicRouteTemplate'] : string;
 /**
  * The main routing type for Expo Router.
  *
@@ -29,70 +5,54 @@ export type DynamicRouteTemplate = ExpoRouter.__routes extends {
  * @hidden
  */
 export declare namespace ExpoRouter {
-    interface __routes<T extends string = string> extends Record<string, unknown> {
+    interface __routes {
     }
 }
-/**
- * @hidden
- */
-export type Routes = DynamicRouteTemplate | AllUngroupedRoutes<StaticRoutes>;
-/**
- * The main routing type for Expo Router. Includes all available routes with strongly typed parameters.
+export type RelativePathString = `./${string}` | `../${string}` | '..';
+export type SearchOrHash = `?${string}` | `#${string}`;
+export type ExternalPathString = `${string}:${string}` | `//${string}`;
+export type Route = Exclude<Extract<Href, object>['pathname'], // Use the HrefObject, as it doesn't have query params
+// Use the HrefObject, as it doesn't have query params
+RelativePathString | ExternalPathString>;
+/**
+ * The main routing type for Expo Router. It includes all available routes with strongly
+ * typed parameters. It can either be:
+ * - **string**: A full path like `/profile/settings` or a relative path like `../settings`.
+ * - **object**: An object with a `pathname` and optional `params`. The `pathname` can be
+ * a full path like `/profile/settings` or a relative path like `../settings`.
+ * The params can be an object of key-value pairs.
  *
  * A Href can either be a string or an object.
- *
- * Href accepts an optional T parameter to correctly type dynamic routes string.
- *
- * For example: Without the generic the route `/folder/[slug]` will be typed as `/folder/${string}`,
- * which is incorrect as `/folder/apple/orange` would be valid. But by passing desired route as a generic `Href<'/folder/apple'>`,
- * it will validate against this edge case.
- *
- */
-export type Href<T extends string | object = {
-    __branded__: any;
-}> = GeneratedHref<T>;
-/**
- * @hidden
- */
-type GeneratedHref<T extends string | object> = StaticRouteToHrefString<AllUngroupedRoutes<StaticRoutes> | RelativePathString | ExternalPathString> | StaticRouteToHrefObject<AllUngroupedRoutes<StaticRoutes> | RelativePathString | ExternalPathString> | DynamicRouteString<T> | DynamicTemplateToHrefObject<DynamicRouteTemplate>;
-/**
- * Converts a static route to a Href string type.
  */
-type StaticRouteToHrefString<T extends string = string> = T | `${T}${SearchOrHash}`;
-/**
- * Converts a static route to a Href object.
- */
-type StaticRouteToHrefObject<T extends string = string> = T extends any ? {
+export type Href = ExpoRouter.__routes extends {
+    href: any;
+} ? ExpoRouter.__routes['href'] : string | {
+    pathname: string;
+    params?: UnknownInputParams;
+};
+export type HrefInputParams = ExpoRouter.__routes extends {
+    hrefInputParams: any;
+} ? ExpoRouter.__routes['hrefInputParams'] : {
+    pathname: string;
+    params?: UnknownInputParams;
+};
+export type HrefOutputParams = ExpoRouter.__routes extends {
+    hrefOutputParams: any;
+} ? ExpoRouter.__routes['hrefOutputParams'] : {
+    pathname: string;
+    params?: UnknownOutputParams;
+};
+export type RouteInputParams<T extends Route> = Extract<Href, {
     pathname: T;
-    params?: RouteParamInput<T> | never;
-} : never;
-/**
- * Converts a dynamic route template to a `Href` string type.
- */
-type DynamicRouteString<T extends string | object, P = DynamicRouteTemplate> = '__branded__' extends keyof T ? DynamicTemplateToHrefString<P> : T extends string ? DynamicRoutes<T> : never;
-/**
- * @hidden
- */
-export type DynamicTemplateToHrefString<Path> = Path extends `${infer PartA}/${infer PartB}` ? `${PartA extends `[${string}]` ? string : PartA}/${DynamicTemplateToHrefString<PartB>}` : Path extends `[${string}]` ? string : Path;
-/**
- * Converts a dynamic route object to a `Href` object.
- */
-type DynamicTemplateToHrefObject<T extends string> = T extends string ? {
+}> extends never ? HrefInputParams extends infer H ? H extends Record<'pathname' | 'params', any> ? T extends H['pathname'] ? H['params'] : never : never : never : Extract<HrefInputParams, {
     pathname: T;
-    params: RouteParamInput<T>;
-} : never;
-/****************
- * Route Utils  *
- ****************/
-type RelativePathString = `./${string}` | `../${string}` | '..';
-type SearchOrHash = `?${string}` | `#${string}`;
-type ExternalPathString = `${string}:${string}`;
-/**
- * Given a route. Returns a union of both that route with and without the groups.
- *
- * The type is recursive and will provide a union of all possible routes.
- */
-type AllUngroupedRoutes<Path> = Path extends `(${infer PartA})/${infer PartB}` ? `(${PartA})/${AllUngroupedRoutes<PartB>}` | AllUngroupedRoutes<PartB> : Path;
+}>['params'];
+export type RouteOutputParams<T extends Route> = Extract<HrefOutputParams, {
+    pathname: T;
+}> extends never ? HrefOutputParams extends infer H ? H extends Record<'pathname' | 'params', any> ? T extends H['pathname'] ? H['params'] : never : never : never : Extract<HrefOutputParams, {
+    pathname: T;
+}>['params'];
+export type RouteParams<T extends Route> = RouteOutputParams<T>;
 /**
  * Routes can have known inputs (e.g query params).
  * Unlike outputs, inputs can be `undefined` or `null`.
@@ -107,27 +67,6 @@ export type UnknownInputParams = Record<string, string | number | undefined | nu
  * @hidden
  */
 export type UnknownOutputParams = Record<string, string | string[]>;
-/**
- * Return the name of a route parameter
- * @example
- * ```
- * '[test]'    -> 'test'
- * 'test'      -> never
- * '[...test]' -> '...test'
- * ```
- */
-type IsParameter<Part> = Part extends `[${infer ParamName}]` ? ParamName : never;
-/**
- * Return a union of all raw parameter names. If there are no names return never.
- *
- * This differs from ParameterNames as it returns the `...` for catch all parameters.
- * @example
- * ```
- * /[test]         -> 'test'
- * /[abc]/[...def] -> 'abc'|'...def'
- * ```
- */
-type ParameterNames<Path> = Path extends `${infer PartA}/${infer PartB}` ? PartA extends '.' ? ParameterNames<PartB> : IsParameter<PartA> | ParameterNames<PartB> : IsParameter<Path>;
 /**
  * Return only the RoutePart of a string. If the string has multiple parts return never
  *
@@ -142,47 +81,7 @@ type ParameterNames<Path> = Path extends `${infer PartA}/${infer PartB}` ? PartA
  *
  * @hidden
  */
-export type SingleRoutePart<S extends string> = S extends `${string}/${string}` ? never : S extends `${string}${SearchOrHash}` ? never : S extends '' ? never : S extends `(${string})` ? never : S extends `[${string}]` ? never : S;
-/**
- * Returns a Record of the routes parameters as strings and CatchAll parameters
- *
- * There are two versions, input and output, as you can input 'string | number' but
- *  the output will always be 'string'
- *
- * @example
- * ```
- * /[id]/[...rest] -> { id: string, rest: string[] }
- * /no-params      -> {}
- * ```
- */
-export type StrictRouteParamsInputs<Path> = {
-    [Key in ParameterNames<Path> as Key extends `...${infer Name}` ? Name : Key]: Key extends `...${string}` ? (string | number)[] : string | number;
-};
-/**
- * Returns a Record of the routes parameters as strings and CatchAll parameters
- *
- * There are two versions, input and output, as you can input 'string | number' but
- *  the output will always be 'string'
- *
- * @see {@link StrictRouteParamsInputs} for the input version
- *
- * @example
- * ```
- * /[id]/[...rest] -> { id: string, rest: string[] }
- * /no-params      -> {}
- * ```
- */
-export type StrictRouteParamsOutput<Path> = {
-    [Key in ParameterNames<Path> as Key extends `...${infer Name}` ? Name : Key]: Key extends `...${string}` ? string[] : string;
-};
-/**
- * @hidden
- */
-export type RouteParamInput<Path> = StrictRouteParamsInputs<Path> & UnknownInputParams;
-/**
- * @hidden
- */
-export type RouteParams<PathOrObject extends Routes | UnknownOutputParams, ExtraPathOrObject extends UnknownOutputParams = UnknownOutputParams> = PathOrObject extends string ? StrictRouteParamsOutput<PathOrObject> & ExtraPathOrObject : PathOrObject;
+export type SingleRoutePart<S extends string | object> = S extends object ? never : S extends `${string}/${string}` ? never : S extends `${string}${SearchOrHash}` ? never : S extends '' ? never : S extends `(${string})` ? never : S extends `[${string}]` ? never : S;
 /**
  * @deprecated Use `RouteParams` or `StrictRouteParams` instead.
  *
@@ -192,6 +91,5 @@ export type SearchParams<T extends string = never> = RouteParams<T>;
 /**
  * @hidden
  */
-export type RouteSegments<PathOrStringArray extends string | string[]> = PathOrStringArray extends string[] ? PathOrStringArray : PathOrStringArray extends `/${infer PartA}` ? RouteSegments<PartA> : PathOrStringArray extends `${infer PartA}/${infer PartB}` ? [PartA, ...RouteSegments<PartB>] : HasTypedRoutes extends true ? [PathOrStringArray] : string[];
-export {};
+export type RouteSegments<HrefOrSegments extends Route | string[]> = HrefOrSegments extends string[] ? HrefOrSegments : HrefOrSegments extends `.${string}` ? never : HrefOrSegments extends `` ? never : HrefOrSegments extends `/${infer PartA}` ? RouteSegments<PartA> : HrefOrSegments extends `${infer PartA}?${string}` ? RouteSegments<PartA> : HrefOrSegments extends `${infer PartA}#${string}` ? RouteSegments<PartA> : HrefOrSegments extends `${infer PartA}/${infer PartB}` ? [PartA, ...RouteSegments<PartB>] : [HrefOrSegments];
 //# sourceMappingURL=types.d.ts.map

package/build/typed-routes/types.d.ts.map

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

package/build/typed-routes/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/typed-routes/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * @hidden\n */\ntype HasTypedRoutes = ExpoRouter.__routes extends { StaticRoutes: string } ? true : false;\n\n/**\n * @hidden\n */\nexport type StaticRoutes = ExpoRouter.__routes extends { StaticRoutes: string }\n  ? ExpoRouter.__routes['StaticRoutes']\n  : string;\n\n/**\n * @hidden\n */\nexport type DynamicRoutes<T extends string> =\n  ExpoRouter.__routes<T> extends {\n    DynamicRoutes: any;\n  }\n    ? // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      T extends ExpoRouter.__routes<infer _>['DynamicRoutes']\n      ? T\n      : never\n    : string;\n\n/**\n * @hidden\n */\nexport type DynamicRouteTemplate = ExpoRouter.__routes extends { DynamicRouteTemplate: string }\n  ? ExpoRouter.__routes['DynamicRouteTemplate']\n  : string;\n\n/**\n * The main routing type for Expo Router.\n *\n * @internal\n * @hidden\n */\nexport namespace ExpoRouter {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  export interface __routes<T extends string = string> extends Record<string, unknown> {}\n}\n\n/**\n * @hidden\n */\nexport type Routes = DynamicRouteTemplate | AllUngroupedRoutes<StaticRoutes>;\n\n/**\n * The main routing type for Expo Router. Includes all available routes with strongly typed parameters.\n *\n * A Href can either be a string or an object.\n *\n * Href accepts an optional T parameter to correctly type dynamic routes string.\n *\n * For example: Without the generic the route `/folder/[slug]` will be typed as `/folder/${string}`,\n * which is incorrect as `/folder/apple/orange` would be valid. But by passing desired route as a generic `Href<'/folder/apple'>`,\n * it will validate against this edge case.\n *\n */\nexport type Href<T extends string | object = { __branded__: any }> = GeneratedHref<T>;\n\n/**\n * @hidden\n */\ntype GeneratedHref<T extends string | object> =\n  | StaticRouteToHrefString<\n      AllUngroupedRoutes<StaticRoutes> | RelativePathString | ExternalPathString\n    >\n  | StaticRouteToHrefObject<\n      AllUngroupedRoutes<StaticRoutes> | RelativePathString | ExternalPathString\n    >\n  | DynamicRouteString<T>\n  | DynamicTemplateToHrefObject<DynamicRouteTemplate>;\n\n/**\n * Converts a static route to a Href string type.\n */\ntype StaticRouteToHrefString<T extends string = string> = T | `${T}${SearchOrHash}`;\n\n/**\n * Converts a static route to a Href object.\n */\ntype StaticRouteToHrefObject<T extends string = string> = T extends any\n  ? {\n      pathname: T;\n      params?: RouteParamInput<T> | never;\n    }\n  : never;\n\n/**\n * Converts a dynamic route template to a `Href` string type.\n */\ntype DynamicRouteString<\n  T extends string | object,\n  P = DynamicRouteTemplate,\n> = '__branded__' extends keyof T\n  ? DynamicTemplateToHrefString<P>\n  : T extends string\n    ? DynamicRoutes<T>\n    : never;\n\n/**\n * @hidden\n */\nexport type DynamicTemplateToHrefString<Path> = Path extends `${infer PartA}/${infer PartB}`\n  ? // If the current segment (PartA) is dynamic, allow any string. This loop again with the next segment (PartB)\n    `${PartA extends `[${string}]` ? string : PartA}/${DynamicTemplateToHrefString<PartB>}`\n  : // Path is the last segment.\n    Path extends `[${string}]`\n    ? string\n    : Path;\n\n/**\n * Converts a dynamic route object to a `Href` object.\n */\ntype DynamicTemplateToHrefObject<T extends string> = T extends string\n  ? {\n      pathname: T;\n      params: RouteParamInput<T>;\n    }\n  : never;\n\n/****************\n * Route Utils  *\n ****************/\n\ntype RelativePathString = `./${string}` | `../${string}` | '..';\ntype SearchOrHash = `?${string}` | `#${string}`;\ntype ExternalPathString = `${string}:${string}`;\n\n/**\n * Given a route. Returns a union of both that route with and without the groups.\n *\n * The type is recursive and will provide a union of all possible routes.\n */\ntype AllUngroupedRoutes<Path> = Path extends `(${infer PartA})/${infer PartB}`\n  ? `(${PartA})/${AllUngroupedRoutes<PartB>}` | AllUngroupedRoutes<PartB>\n  : Path;\n\n/**\n * Routes can have known inputs (e.g query params).\n * Unlike outputs, inputs can be `undefined` or `null`.\n *\n * @hidden\n */\nexport type UnknownInputParams = Record<\n  string,\n  string | number | undefined | null | (string | number)[]\n>;\n\n/**\n * Routes can have unknown outputs (e.g query params).\n * Unlike inputs, outputs can't be undefined or null.\n *\n * @hidden\n */\nexport type UnknownOutputParams = Record<string, string | string[]>;\n\n/**\n * Return the name of a route parameter\n * @example\n * ```\n * '[test]'    -> 'test'\n * 'test'      -> never\n * '[...test]' -> '...test'\n * ```\n */\ntype IsParameter<Part> = Part extends `[${infer ParamName}]` ? ParamName : never;\n\n/**\n * Return a union of all raw parameter names. If there are no names return never.\n *\n * This differs from ParameterNames as it returns the `...` for catch all parameters.\n * @example\n * ```\n * /[test]         -> 'test'\n * /[abc]/[...def] -> 'abc'|'...def'\n * ```\n */\ntype ParameterNames<Path> = Path extends `${infer PartA}/${infer PartB}`\n  ? PartA extends '.' // Skip relative paths\n    ? ParameterNames<PartB>\n    : IsParameter<PartA> | ParameterNames<PartB>\n  : IsParameter<Path>;\n\n/**\n * Return only the RoutePart of a string. If the string has multiple parts return never\n *\n * string   | type\n *| ---------|------|\n *| 123      | 123 |\n *| /123/abc | never |\n *| 123?abc  | never |\n *| ./123    | never |\n *| /123     | never |\n *| 123/../  | never |\n *\n * @hidden\n */\nexport type SingleRoutePart<S extends string> = S extends `${string}/${string}`\n  ? never\n  : S extends `${string}${SearchOrHash}`\n    ? never\n    : S extends ''\n      ? never\n      : S extends `(${string})`\n        ? never\n        : S extends `[${string}]`\n          ? never\n          : S;\n\n/**\n * Returns a Record of the routes parameters as strings and CatchAll parameters\n *\n * There are two versions, input and output, as you can input 'string | number' but\n *  the output will always be 'string'\n *\n * @example\n * ```\n * /[id]/[...rest] -> { id: string, rest: string[] }\n * /no-params      -> {}\n * ```\n */\nexport type StrictRouteParamsInputs<Path> = {\n  [Key in ParameterNames<Path> as Key extends `...${infer Name}`\n    ? Name\n    : Key]: Key extends `...${string}` ? (string | number)[] : string | number;\n};\n\n/**\n * Returns a Record of the routes parameters as strings and CatchAll parameters\n *\n * There are two versions, input and output, as you can input 'string | number' but\n *  the output will always be 'string'\n *\n * @see {@link StrictRouteParamsInputs} for the input version\n *\n * @example\n * ```\n * /[id]/[...rest] -> { id: string, rest: string[] }\n * /no-params      -> {}\n * ```\n */\nexport type StrictRouteParamsOutput<Path> = {\n  [Key in ParameterNames<Path> as Key extends `...${infer Name}`\n    ? Name\n    : Key]: Key extends `...${string}` ? string[] : string;\n};\n\n/**\n * @hidden\n */\nexport type RouteParamInput<Path> = StrictRouteParamsInputs<Path> & UnknownInputParams;\n\n/**\n * @hidden\n */\nexport type RouteParams<\n  PathOrObject extends Routes | UnknownOutputParams,\n  ExtraPathOrObject extends UnknownOutputParams = UnknownOutputParams,\n> = PathOrObject extends string\n  ? StrictRouteParamsOutput<PathOrObject> & ExtraPathOrObject\n  : PathOrObject;\n\n/**\n * @deprecated Use `RouteParams` or `StrictRouteParams` instead.\n *\n * @hidden\n */\nexport type SearchParams<T extends string = never> = RouteParams<T>;\n\n/**\n * @hidden\n */\nexport type RouteSegments<PathOrStringArray extends string | string[]> =\n  PathOrStringArray extends string[]\n    ? PathOrStringArray\n    : PathOrStringArray extends `/${infer PartA}`\n      ? RouteSegments<PartA>\n      : PathOrStringArray extends `${infer PartA}/${infer PartB}`\n        ? [PartA, ...RouteSegments<PartB>]\n        : HasTypedRoutes extends true\n          ? [PathOrStringArray]\n          : string[];\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/typed-routes/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * The main routing type for Expo Router.\n *\n * @internal\n * @hidden\n */\nexport namespace ExpoRouter {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-empty-object-type\n  export interface __routes {}\n}\n\nexport type RelativePathString = `./${string}` | `../${string}` | '..';\nexport type SearchOrHash = `?${string}` | `#${string}`;\nexport type ExternalPathString = `${string}:${string}` | `//${string}`;\nexport type Route = Exclude<\n  Extract<Href, object>['pathname'], // Use the HrefObject, as it doesn't have query params\n  RelativePathString | ExternalPathString\n>;\n\n/**\n * The main routing type for Expo Router. It includes all available routes with strongly\n * typed parameters. It can either be:\n * - **string**: A full path like `/profile/settings` or a relative path like `../settings`.\n * - **object**: An object with a `pathname` and optional `params`. The `pathname` can be\n * a full path like `/profile/settings` or a relative path like `../settings`.\n * The params can be an object of key-value pairs.\n *\n * A Href can either be a string or an object.\n */\nexport type Href = ExpoRouter.__routes extends { href: any }\n  ? ExpoRouter.__routes['href']\n  : string | { pathname: string; params?: UnknownInputParams };\n\nexport type HrefInputParams = ExpoRouter.__routes extends { hrefInputParams: any }\n  ? ExpoRouter.__routes['hrefInputParams']\n  : { pathname: string; params?: UnknownInputParams };\n\nexport type HrefOutputParams = ExpoRouter.__routes extends { hrefOutputParams: any }\n  ? ExpoRouter.__routes['hrefOutputParams']\n  : { pathname: string; params?: UnknownOutputParams };\n\nexport type RouteInputParams<T extends Route> =\n  Extract<Href, { pathname: T }> extends never\n    ? HrefInputParams extends infer H\n      ? H extends Record<'pathname' | 'params', any>\n        ? T extends H['pathname']\n          ? H['params']\n          : never\n        : never\n      : never\n    : Extract<HrefInputParams, { pathname: T }>['params'];\n\nexport type RouteOutputParams<T extends Route> =\n  Extract<HrefOutputParams, { pathname: T }> extends never\n    ? HrefOutputParams extends infer H\n      ? H extends Record<'pathname' | 'params', any>\n        ? T extends H['pathname']\n          ? H['params']\n          : never\n        : never\n      : never\n    : Extract<HrefOutputParams, { pathname: T }>['params'];\n\nexport type RouteParams<T extends Route> = RouteOutputParams<T>;\n\n/**\n * Routes can have known inputs (e.g query params).\n * Unlike outputs, inputs can be `undefined` or `null`.\n *\n * @hidden\n */\nexport type UnknownInputParams = Record<\n  string,\n  string | number | undefined | null | (string | number)[]\n>;\n\n/**\n * Routes can have unknown outputs (e.g query params).\n * Unlike inputs, outputs can't be undefined or null.\n *\n * @hidden\n */\nexport type UnknownOutputParams = Record<string, string | string[]>;\n\n/**\n * Return only the RoutePart of a string. If the string has multiple parts return never\n *\n * string   | type\n *| ---------|------|\n *| 123      | 123 |\n *| /123/abc | never |\n *| 123?abc  | never |\n *| ./123    | never |\n *| /123     | never |\n *| 123/../  | never |\n *\n * @hidden\n */\nexport type SingleRoutePart<S extends string | object> = S extends object\n  ? never\n  : S extends `${string}/${string}`\n    ? never\n    : S extends `${string}${SearchOrHash}`\n      ? never\n      : S extends ''\n        ? never\n        : S extends `(${string})`\n          ? never\n          : S extends `[${string}]`\n            ? never\n            : S;\n\n/**\n * @deprecated Use `RouteParams` or `StrictRouteParams` instead.\n *\n * @hidden\n */\nexport type SearchParams<T extends string = never> = RouteParams<T>;\n\n/**\n * @hidden\n */\nexport type RouteSegments<HrefOrSegments extends Route | string[]> = HrefOrSegments extends string[]\n  ? HrefOrSegments\n  : HrefOrSegments extends `.${string}`\n    ? never\n    : HrefOrSegments extends ``\n      ? never\n      : HrefOrSegments extends `/${infer PartA}`\n        ? RouteSegments<PartA>\n        : HrefOrSegments extends `${infer PartA}?${string}`\n          ? RouteSegments<PartA>\n          : HrefOrSegments extends `${infer PartA}#${string}`\n            ? RouteSegments<PartA>\n            : HrefOrSegments extends `${infer PartA}/${infer PartB}`\n              ? [PartA, ...RouteSegments<PartB>]\n              : [HrefOrSegments];\n"]}

package/build/types.d.ts

@@ -15,11 +15,44 @@ export interface RequireContext {
  * The list of input keys will become optional, everything else will remain the same.
  */
 export type PickPartial<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Created by using a special file called `+native-intent.tsx` at the top-level of your
+ * project's **app** directory. It exports `redirectSystemPath` or `legacy_subscribe` functions,
+ * both methods designed to handle URL/path processing.
+ *
+ * Useful for re-writing URLs to correctly target a route when unique/referred URLs
+ * are incoming from third-party providers or stale URLs from previous versions.
+ *
+ * @see For more information on how to use `NativeIntent`, see [Customizing links](/router/advanced/native-intent/).
+ */
 export type NativeIntent = {
+    /**
+     * A special method used to process URLs in native apps. When invoked, it receives an
+     * `options` object with the following properties:
+     * - **path**: represents the URL or path undergoing processing.
+     * - **initial**: a boolean indicating whether the path is the app's initial URL.
+     *
+     * It's return value should either be a `string` or a `Promise<string>`.
+     * Note that throwing errors within this method may result in app crashes. It's recommended to
+     * wrap your code inside a `try/catch` block and utilize `.catch()` when appropriate.
+     *
+     * @see For usage information, see [Redirecting system paths](/router/advanced/native-intent/#redirectsystempath).
+     */
     redirectSystemPath?: (event: {
         path: string;
         initial: boolean;
     }) => Promise<string> | string;
+    /**
+     * > **warning** Experimentally available in SDK 52.
+     *
+     * Useful as an alternative API when a third-party provider doesn't support Expo Router
+     * but has support for React Navigation via `Linking.subscribe()` for existing projects.
+     *
+     * Using this API is not recommended for newer projects or integrations since it is
+     * incompatible with Server Side Routing and
+     * [Static Rendering](/router/reference/static-rendering/), and can become challenging to manage while offline or in a low network environment.
+     *
+     */
     legacy_subscribe?: (listener: (url: string) => void) => undefined | void | (() => void);
 };
 export type * from './typed-routes/types';

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC;IAClB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;IACnB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAEjF,MAAM,MAAM,YAAY,GAAG;IACzB,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC7F,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KAAK,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;CACzF,CAAC;AAEF,mBAAmB,sBAAsB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC;IAClB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;IACnB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAEjF;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC7F;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KAAK,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;CACzF,CAAC;AAEF,mBAAmB,sBAAsB,CAAC"}

package/build/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["// TODO: Use the global type\n/**\n * @hidden\n */\nexport interface RequireContext {\n  /** Return the keys that can be resolved. */\n  keys(): string[];\n  (id: string): any;\n  <T>(id: string): T;\n  /** **Unimplemented:** Return the module identifier for a user request. */\n  resolve(id: string): string;\n  /** **Unimplemented:** Readable identifier for the context module. */\n  id: string;\n}\n\n/**\n * The list of input keys will become optional, everything else will remain the same.\n */\nexport type PickPartial<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;\n\nexport type NativeIntent = {\n  redirectSystemPath?: (event: { path: string; initial: boolean }) => Promise<string> | string;\n  legacy_subscribe?: (listener: (url: string) => void) => undefined | void | (() => void);\n};\n\nexport type * from './typed-routes/types';\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["// TODO: Use the global type\n/**\n * @hidden\n */\nexport interface RequireContext {\n  /** Return the keys that can be resolved. */\n  keys(): string[];\n  (id: string): any;\n  <T>(id: string): T;\n  /** **Unimplemented:** Return the module identifier for a user request. */\n  resolve(id: string): string;\n  /** **Unimplemented:** Readable identifier for the context module. */\n  id: string;\n}\n\n/**\n * The list of input keys will become optional, everything else will remain the same.\n */\nexport type PickPartial<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;\n\n/**\n * Created by using a special file called `+native-intent.tsx` at the top-level of your\n * project's **app** directory. It exports `redirectSystemPath` or `legacy_subscribe` functions,\n * both methods designed to handle URL/path processing.\n *\n * Useful for re-writing URLs to correctly target a route when unique/referred URLs\n * are incoming from third-party providers or stale URLs from previous versions.\n *\n * @see For more information on how to use `NativeIntent`, see [Customizing links](/router/advanced/native-intent/).\n */\nexport type NativeIntent = {\n  /**\n   * A special method used to process URLs in native apps. When invoked, it receives an\n   * `options` object with the following properties:\n   * - **path**: represents the URL or path undergoing processing.\n   * - **initial**: a boolean indicating whether the path is the app's initial URL.\n   *\n   * It's return value should either be a `string` or a `Promise<string>`.\n   * Note that throwing errors within this method may result in app crashes. It's recommended to\n   * wrap your code inside a `try/catch` block and utilize `.catch()` when appropriate.\n   *\n   * @see For usage information, see [Redirecting system paths](/router/advanced/native-intent/#redirectsystempath).\n   */\n  redirectSystemPath?: (event: { path: string; initial: boolean }) => Promise<string> | string;\n  /**\n   * > **warning** Experimentally available in SDK 52.\n   *\n   * Useful as an alternative API when a third-party provider doesn't support Expo Router\n   * but has support for React Navigation via `Linking.subscribe()` for existing projects.\n   *\n   * Using this API is not recommended for newer projects or integrations since it is\n   * incompatible with Server Side Routing and\n   * [Static Rendering](/router/reference/static-rendering/), and can become challenging to manage while offline or in a low network environment.\n   *\n   */\n  legacy_subscribe?: (listener: (url: string) => void) => undefined | void | (() => void);\n};\n\nexport type * from './typed-routes/types';\n"]}