one 1.2.16 → 1.2.18

package/dist/esm/vite/plugins/generateFileSystemRouteTypesPlugin.mjs

@@ -11,11 +11,12 @@ function generateFileSystemRouteTypesPlugin(options) {
       const appDir = join(process.cwd(), getRouterRootFromOneOptions(options)),
         outFile = join(appDir, "routes.d.ts"),
         routerRoot = getRouterRootFromOneOptions(options),
+        typedRoutesGeneration = options.router?.experimental?.typedRoutesGeneration || void 0,
         fileWatcherChangeListener = debounce(async (type, path) => {
-          (type === "add" || type === "delete") && path.startsWith(appDir) && generateRouteTypes(outFile, routerRoot, options.router?.ignoredRouteFiles);
+          (type === "add" || type === "delete" || type === "change") && path.startsWith(appDir) && generateRouteTypes(outFile, routerRoot, options.router?.ignoredRouteFiles, typedRoutesGeneration);
         }, 100);
       return server.watcher.addListener("all", fileWatcherChangeListener), () => {
-        generateRouteTypes(outFile, routerRoot, options.router?.ignoredRouteFiles);
+        generateRouteTypes(outFile, routerRoot, options.router?.ignoredRouteFiles, typedRoutesGeneration);
       };
     }
   };

package/dist/esm/vite/plugins/generateFileSystemRouteTypesPlugin.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["join","debounce","generateRouteTypes","getRouterRootFromOneOptions","generateFileSystemRouteTypesPlugin","options","name","enforce","apply","configureServer","server","appDir","process","cwd","outFile","routerRoot","fileWatcherChangeListener","type","path","startsWith","router","ignoredRouteFiles","watcher","addListener"],"sources":["../../../../src/vite/plugins/generateFileSystemRouteTypesPlugin.tsx"],"sourcesContent":[null],"mappings":"AAAA,SAASA,IAAA,QAAY;AACrB,SAASC,QAAA,QAAgB;AAEzB,SAASC,kBAAA,QAA0B;AACnC,SAASC,2BAAA,QAAmC;AAGrC,SAASC,mCAAmCC,OAAA,EAAoC;EACrF,OAAO;IACLC,IAAA,EAAM;IACNC,OAAA,EAAS;IACTC,KAAA,EAAO;IAEPC,gBAAgBC,MAAA,EAAQ;MACtB,MAAMC,MAAA,GAASX,IAAA,CAAKY,OAAA,CAAQC,GAAA,CAAI,GAAGV,2BAAA,CAA4BE,OAAO,CAAC;QAEjES,OAAA,GAAUd,IAAA,CAAKW,MAAA,EAAQ,aAAa;QAEpCI,UAAA,GAAaZ,2BAAA,CAA4BE,OAAO;QAGhDW,yBAAA,GAA4Bf,QAAA,CAAS,OAAOgB,IAAA,EAAcC,IAAA,KAAiB;UAC/E,CAAID,IAAA,KAAS,SAASA,IAAA,KAAS,aACzBC,IAAA,CAAKC,UAAA,CAAWR,MAAM,KAExBT,kBAAA,CAAmBY,OAAA,EAASC,UAAA,EAAYV,OAAA,CAAQe,MAAA,EAAQC,iBAAiB;QAG/E,GAAG,GAAG;MAEN,OAAAX,MAAA,CAAOY,OAAA,CAAQC,WAAA,CAAY,OAAOP,yBAAyB,GAEpD,MAAM;QAGXd,kBAAA,CAAmBY,OAAA,EAASC,UAAA,EAAYV,OAAA,CAAQe,MAAA,EAAQC,iBAAiB;MAC3E;IACF;EACF;AACF","ignoreList":[]}
+{"version":3,"names":["join","debounce","generateRouteTypes","getRouterRootFromOneOptions","generateFileSystemRouteTypesPlugin","options","name","enforce","apply","configureServer","server","appDir","process","cwd","outFile","routerRoot","typedRoutesGeneration","router","experimental","fileWatcherChangeListener","type","path","startsWith","ignoredRouteFiles","watcher","addListener"],"sources":["../../../../src/vite/plugins/generateFileSystemRouteTypesPlugin.tsx"],"sourcesContent":[null],"mappings":"AAAA,SAASA,IAAA,QAAY;AACrB,SAASC,QAAA,QAAgB;AAEzB,SAASC,kBAAA,QAA0B;AACnC,SAASC,2BAAA,QAAmC;AAGrC,SAASC,mCAAmCC,OAAA,EAAoC;EACrF,OAAO;IACLC,IAAA,EAAM;IACNC,OAAA,EAAS;IACTC,KAAA,EAAO;IAEPC,gBAAgBC,MAAA,EAAQ;MACtB,MAAMC,MAAA,GAASX,IAAA,CAAKY,OAAA,CAAQC,GAAA,CAAI,GAAGV,2BAAA,CAA4BE,OAAO,CAAC;QAEjES,OAAA,GAAUd,IAAA,CAAKW,MAAA,EAAQ,aAAa;QAEpCI,UAAA,GAAaZ,2BAAA,CAA4BE,OAAO;QAChDW,qBAAA,GAAwBX,OAAA,CAAQY,MAAA,EAAQC,YAAA,EAAcF,qBAAA,IAAyB;QAG/EG,yBAAA,GAA4BlB,QAAA,CAAS,OAAOmB,IAAA,EAAcC,IAAA,KAAiB;UAC/E,CAAID,IAAA,KAAS,SAASA,IAAA,KAAS,YAAYA,IAAA,KAAS,aAC9CC,IAAA,CAAKC,UAAA,CAAWX,MAAM,KAExBT,kBAAA,CACEY,OAAA,EACAC,UAAA,EACAV,OAAA,CAAQY,MAAA,EAAQM,iBAAA,EAChBP,qBACF;QAGN,GAAG,GAAG;MAEN,OAAAN,MAAA,CAAOc,OAAA,CAAQC,WAAA,CAAY,OAAON,yBAAyB,GAEpD,MAAM;QAGXjB,kBAAA,CACEY,OAAA,EACAC,UAAA,EACAV,OAAA,CAAQY,MAAA,EAAQM,iBAAA,EAChBP,qBACF;MACF;IACF;EACF;AACF","ignoreList":[]}

package/dist/esm/vite/plugins/generateFileSystemRouteTypesPlugin.native.js

@@ -8,18 +8,21 @@ function generateFileSystemRouteTypesPlugin(options) {
     enforce: "post",
     apply: "serve",
     configureServer(server) {
-      var appDir = join(process.cwd(), getRouterRootFromOneOptions(options)),
+      var _options_router_experimental,
+        _options_router,
+        appDir = join(process.cwd(), getRouterRootFromOneOptions(options)),
         outFile = join(appDir, "routes.d.ts"),
         routerRoot = getRouterRootFromOneOptions(options),
+        typedRoutesGeneration = ((_options_router = options.router) === null || _options_router === void 0 || (_options_router_experimental = _options_router.experimental) === null || _options_router_experimental === void 0 ? void 0 : _options_router_experimental.typedRoutesGeneration) || void 0,
         fileWatcherChangeListener = debounce(async function (type, path) {
-          if ((type === "add" || type === "delete") && path.startsWith(appDir)) {
-            var _options_router;
-            generateRouteTypes(outFile, routerRoot, (_options_router = options.router) === null || _options_router === void 0 ? void 0 : _options_router.ignoredRouteFiles);
+          if ((type === "add" || type === "delete" || type === "change") && path.startsWith(appDir)) {
+            var _options_router2;
+            generateRouteTypes(outFile, routerRoot, (_options_router2 = options.router) === null || _options_router2 === void 0 ? void 0 : _options_router2.ignoredRouteFiles, typedRoutesGeneration);
           }
         }, 100);
       return server.watcher.addListener("all", fileWatcherChangeListener), function () {
-        var _options_router;
-        generateRouteTypes(outFile, routerRoot, (_options_router = options.router) === null || _options_router === void 0 ? void 0 : _options_router.ignoredRouteFiles);
+        var _options_router2;
+        generateRouteTypes(outFile, routerRoot, (_options_router2 = options.router) === null || _options_router2 === void 0 ? void 0 : _options_router2.ignoredRouteFiles, typedRoutesGeneration);
       };
     }
   };

package/dist/esm/vite/plugins/generateFileSystemRouteTypesPlugin.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["join","debounce","generateRouteTypes","getRouterRootFromOneOptions","generateFileSystemRouteTypesPlugin","options","name","enforce","apply","configureServer","server","appDir","process","cwd","outFile","routerRoot","fileWatcherChangeListener","type","path","startsWith","_options_router","router","ignoredRouteFiles","watcher","addListener"],"sources":["../../../../src/vite/plugins/generateFileSystemRouteTypesPlugin.tsx"],"sourcesContent":[null],"mappings":"AAAA,SAASA,IAAA,QAAY;AACrB,SAASC,QAAA,QAAgB;AAEzB,SAASC,kBAAA,QAA0B;AACnC,SAASC,2BAAA,QAAmC;AAGrC,SAASC,mCAAmCC,OAAA,EAAoC;EACrF,OAAO;IACLC,IAAA,EAAM;IACNC,OAAA,EAAS;IACTC,KAAA,EAAO;IAEPC,gBAAgBC,MAAA,EAAQ;MACtB,IAAAC,MAAM,GAAAX,IAAS,CAAAY,OAAK,CAAAC,GAAQ,IAAIV,2BAAG,CAAAE,OAA4B,EAAO;QAACS,OAEjE,GAAAd,IAAU,CAAAW,MAAK,eAAQ;QAAaI,UAEpC,GAAAZ,2BAAa,CAAAE,OAA4B;QAAOW,yBAGhD,GAAAf,QAA4B,iBAA8BgB,IAAA,EAAAC,IAAiB;UAC/E,IAAI,CAAAD,IAAA,KAAS,KAAS,IAAAA,IAAA,KAAS,aACzBC,IAAK,CAAAC,UAAW,CAAAR,MAAM,CAExB;YAGH,IAAGS,eAAA;YAENlB,kBAAe,CAAAY,OAAA,EAAAC,UAAmB,GAAAK,eAAA,GAAAf,OAE3B,CAAAgB,MAAM,cAAAD,eAAA,uBAAAA,eAAA,CAAAE,iBAAA;UAGX;QACF;MACF,OAAAZ,MAAA,CAAAa,OAAA,CAAAC,WAAA,QAAAR,yBAAA;QACF,IAAAI,eAAA;QACFlB,kBAAA,CAAAY,OAAA,EAAAC,UAAA,GAAAK,eAAA,GAAAf,OAAA,CAAAgB,MAAA,cAAAD,eAAA,uBAAAA,eAAA,CAAAE,iBAAA","ignoreList":[]}
+{"version":3,"names":["join","debounce","generateRouteTypes","getRouterRootFromOneOptions","generateFileSystemRouteTypesPlugin","options","name","enforce","apply","configureServer","server","_options_router_experimental","_options_router","appDir","process","cwd","outFile","routerRoot","typedRoutesGeneration","router","experimental","fileWatcherChangeListener","type","path","startsWith","_options_router2","ignoredRouteFiles","watcher","addListener"],"sources":["../../../../src/vite/plugins/generateFileSystemRouteTypesPlugin.tsx"],"sourcesContent":[null],"mappings":"AAAA,SAASA,IAAA,QAAY;AACrB,SAASC,QAAA,QAAgB;AAEzB,SAASC,kBAAA,QAA0B;AACnC,SAASC,2BAAA,QAAmC;AAGrC,SAASC,mCAAmCC,OAAA,EAAoC;EACrF,OAAO;IACLC,IAAA,EAAM;IACNC,OAAA,EAAS;IACTC,KAAA,EAAO;IAEPC,gBAAgBC,MAAA,EAAQ;MACtB,IAAAC,4BAAgC;QAAAC,eAAG;QAAAC,MAAA,GAAAb,IAA4B,CAAAc,OAAQ,CAAAC,GAEjE,IAAAZ,2BAAuB,CAAAE,OAEvB;QAAAW,OAAa,GAAAhB,IAAA,CAAAa,MAAA,eAA4B;QAAAI,UACzC,GAAAd,2BAAgC,CAAAE,OAAQ;QAAAa,qBAAc,KAAAN,eAAyB,GAG/EP,OAAA,CAAAc,MAAA,cAA4BP,eAAgB,KAAc,UAAiB,CAAAD,4BAAA,GAAAC,eAAA,CAAAQ,YAAA,cAAAT,4BAAA,uBAAAA,4BAAA,CAAAO,qBAAA;QAAAG,yBAAA,GAAApB,QAAA,iBAAAqB,IAAA,EAAAC,IAAA;UAC/E,IAAI,CAAAD,IAAA,KAAS,KAAS,IAAAA,IAAA,KAAS,QAAY,IAAAA,IAAA,KAAS,aAC9CC,IAAK,CAAAC,UAAW,CAAAX,MAAM,CAExB;YACE,IAAAY,gBAAA;YACAvB,kBAAA,CAAAc,OAAA,EAAAC,UAAA,GAAAQ,gBAAA,GAAApB,OAAA,CAAAc,MAAA,cAAAM,gBAAA,uBAAAA,gBAAA,CAAAC,iBAAA,EAAAR,qBAAA;UAAA;QACgB,MAChB;MAAA,OACFR,MAAA,CAAAiB,OAAA,CAAAC,WAAA,QAAAP,yBAAA;QAGN,IAAMI,gBAAA;QAENvB,kBAAO,CAAAc,OAAQ,EAAAC,UAAY,EAAO,CAAAQ,gBAAA,GAAApB,OAE3B,CAAAc,MAAM,cAAAM,gBAAA,uBAAAA,gBAAA,CAAAC,iBAAA,EAAAR,qBAAA;MAGX;IAAA;EACE;AACA;AACgB,SAChBd,kCACF","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "one",
-  "version": "1.2.16",
+  "version": "1.2.18",
   "license": "BSD-3-Clause",
   "sideEffects": [
     "setup.mjs",
@@ -121,17 +121,17 @@
     "@react-navigation/routers": "~7.5.1",
     "@swc/core": "^1.14.0",
     "@ungap/structured-clone": "^1.2.0",
-    "@vxrn/compiler": "1.2.16",
-    "@vxrn/resolve": "1.2.16",
-    "@vxrn/tslib-lite": "1.2.16",
-    "@vxrn/universal-color-scheme": "1.2.16",
-    "@vxrn/use-isomorphic-layout-effect": "1.2.16",
-    "@vxrn/vite-plugin-metro": "1.2.16",
+    "@vxrn/compiler": "1.2.18",
+    "@vxrn/resolve": "1.2.18",
+    "@vxrn/tslib-lite": "1.2.18",
+    "@vxrn/universal-color-scheme": "1.2.18",
+    "@vxrn/use-isomorphic-layout-effect": "1.2.18",
+    "@vxrn/vite-plugin-metro": "1.2.18",
     "babel-dead-code-elimination": "^1.0.10",
     "babel-plugin-module-resolver": "^5.0.2",
     "citty": "^0.1.6",
     "core-js": "^3.38.1",
-    "create-vxrn": "1.2.16",
+    "create-vxrn": "1.2.18",
     "escape-string-regexp": "^5.0.0",
     "expo-linking": "~8.0.8",
     "expo-modules-core": "~3.0.24",
@@ -157,7 +157,7 @@
     "vite": "^7.1.12",
     "vite-plugin-barrel": "^0.4.1",
     "vite-tsconfig-paths": "^5.1.4",
-    "vxrn": "1.2.16",
+    "vxrn": "1.2.18",
     "ws": "^8.18.0",
     "xxhashjs": "^0.2.2"
   },
@@ -175,7 +175,7 @@
   "devDependencies": {
     "@react-navigation/core": "^7.13.0",
     "@react-navigation/native": "~7.1.19",
-    "@tamagui/build": "^1.136.1",
+    "@tamagui/build": "^1.137.3",
     "@types/node": "^24.10.0",
     "@types/react-dom": "^19.2.2",
     "@types/xxhashjs": "^0.2.4",

package/src/cli/generateRoutes.ts

@@ -1,12 +1,39 @@
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
 import { generateRouteTypes } from '../typed-routes/generateRouteTypes'
+import { getRouterRootFromOneOptions } from '../utils/getRouterRootFromOneOptions'
+import { loadUserOneOptions } from '../vite/loadConfig'
 
-export async function run(args: { appDir?: string } = {}) {
+export async function run(args: { appDir?: string; typed?: string } = {}) {
   const cwd = process.cwd()
 
-  // Use provided appDir or default to 'app'
-  const routerRoot = args.appDir || 'app'
+  // Try to load config to get One options
+  let oneOptions
+  let routerRoot: string
+  let ignoredRouteFiles: string[] | undefined
+
+  try {
+    // Suppress stderr during config load (Vite may output resolution errors)
+    const originalStderrWrite = process.stderr.write
+    let stderrBuffer = ''
+    process.stderr.write = ((chunk: any) => {
+      stderrBuffer += chunk
+      return true
+    }) as any
+
+    try {
+      const loaded = await loadUserOneOptions('build')
+      oneOptions = loaded.oneOptions
+      routerRoot = args.appDir || getRouterRootFromOneOptions(oneOptions)
+      ignoredRouteFiles = oneOptions.router?.ignoredRouteFiles
+    } finally {
+      process.stderr.write = originalStderrWrite
+    }
+  } catch (error) {
+    // Config loading failed - use defaults
+    routerRoot = args.appDir || 'app'
+  }
+
   const appDir = join(cwd, routerRoot)
 
   if (!existsSync(appDir)) {
@@ -19,5 +46,26 @@ export async function run(args: { appDir?: string } = {}) {
 
   const outFile = join(appDir, 'routes.d.ts')
 
-  await generateRouteTypes(outFile, routerRoot, undefined)
+  // Get typed routes mode from CLI arg or config (CLI arg takes precedence)
+  let typedRoutesMode: 'type' | 'runtime' | undefined
+
+  if (args.typed) {
+    // CLI arg provided - validate and use it
+    if (args.typed === 'type' || args.typed === 'runtime') {
+      typedRoutesMode = args.typed
+    } else {
+      console.error(`Error: Invalid --typed value "${args.typed}". Must be "type" or "runtime"`)
+      process.exit(1)
+    }
+  } else if (oneOptions) {
+    // No CLI arg - use config value if available
+    typedRoutesMode = oneOptions.router?.experimental?.typedRoutesGeneration || undefined
+  }
+  if (typedRoutesMode) {
+  } else if (!args.typed) {
+  }
+
+  await generateRouteTypes(outFile, routerRoot, ignoredRouteFiles, typedRoutesMode)
+  if (typedRoutesMode) {
+  }
 }

package/src/cli.ts

@@ -251,6 +251,11 @@ const generateRoutes = defineCommand({
       type: 'string',
       description: 'Path to app directory (default: "app")',
     },
+    typed: {
+      type: 'string',
+      description:
+        'Auto-generate route helpers. Options: "type" (type-only helpers) or "runtime" (runtime helpers)',
+    },
   },
   async run({ args }) {
     const { run } = await import('./cli/generateRoutes')

package/src/getDevServer.native.ts

@@ -0,0 +1,5 @@
+// Isolated to suppress deprecation warning for deep import
+// React Native 0.81+ discourages deep imports but doesn't provide official alternative yet
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore - Types not exported from react-native
+export { default as getDevServer } from 'react-native/Libraries/Core/Devtools/getDevServer'

package/src/getDevServer.ts

@@ -0,0 +1,5 @@
+// Web/SSR version - returns dummy values
+export const getDevServer = () => ({
+  url: '',
+  bundleLoadedFromServer: false,
+})

package/src/getURL.native.ts

@@ -1,4 +1,6 @@
-import getDevServer from 'react-native/Libraries/Core/Devtools/getDevServer'
+import { getDevServer } from './getDevServer'
+
+let hasWarnedOnce = false
 
 export function getURL() {
   let url = process.env.ONE_SERVER_URL
@@ -6,12 +8,15 @@ export function getURL() {
   if (__DEV__) {
     // We'll be using the development server in development mode, but we still need to warn the user to set SERVER_URL for things to work in production.
     if (!url) {
-      console.warn(
-        `The ONE_SERVER_URL environment variable is not set. While things will work in development mode as we'll be using your development server, you should still set ONE_SERVER_URL in your .env file for your production builds to work.`
-      )
+      if (hasWarnedOnce) {
+        hasWarnedOnce = true
+        console.warn(
+          `The ONE_SERVER_URL environment variable is not set. While things will work in development mode as we'll be using your development server, you should still set ONE_SERVER_URL in your .env file for your production builds to work.`
+        )
+      }
     }
 
-    const { url: devServerUrl } = getDevServer() as { url: string }
+    const { url: devServerUrl } = getDevServer()
     url = devServerUrl
   }
 

package/src/index.ts

@@ -9,6 +9,19 @@ export type Href = '__branded__' extends keyof OneRouter.Href ? string : OneRout
 
 export type LinkProps<T extends string | object = string> = OneRouter.LinkProps<T>
 
+/**
+ * Helper type to get route information including params and loader props.
+ * Can be overridden in generated routes.d.ts for per-route types.
+ *
+ * @example
+ * import type { RouteType } from 'one'
+ *
+ * type MyRoute = RouteType<'(site)/docs/[slug]'>
+ * // MyRoute.Params = { slug: string }
+ * // MyRoute.LoaderProps = { params: { slug: string }, path: string, request?: Request }
+ */
+export type RouteType<Path extends string = string> = OneRouter.RouteType<Path>
+
 // hooks
 export { useIsFocused } from '@react-navigation/core'
 // re-export

package/src/interfaces/router.ts

@@ -16,6 +16,25 @@ export namespace OneRouter {
     Loader: (props: { params: InputRouteParams<Path> }) => any
   }
 
+  /**
+   * Helper type to get route information including params and loader props.
+   * Uses generated RouteTypes from routes.d.ts if available for better intellisense.
+   *
+   * @example
+   * const route = createRoute<'/docs/[slug]'>()
+   * // route.createLoader gets params typed as { slug: string }
+   *
+   * type Route = RouteType<'/docs/[slug]'>
+   * // Route.Params = { slug: string }
+   * // Route.LoaderProps = { path: string; params: { slug: string }; request?: Request }
+   */
+  export type RouteType<Path extends string> = Path extends keyof __routes['RouteTypes']
+    ? __routes['RouteTypes'][Path]
+    : {
+        Params: InputRouteParams<Path>
+        LoaderProps: import('../types').LoaderProps<InputRouteParams<Path>>
+      }
+
   type StaticRoutes = __routes extends { StaticRoutes: string } ? __routes['StaticRoutes'] : string
 
   type DynamicRoutes<T extends string> = __routes<T> extends { DynamicRoutes: any }

package/src/router/createRoute.ts

@@ -1,14 +1,27 @@
 import { useActiveParams, useParams, usePathname } from '../hooks'
 import type { OneRouter } from '../interfaces/router'
+import type { LoaderProps } from '../types'
 
-export function createRoute<Path>() {
-  type Route = OneRouter.Route<Path>
+export function createRoute<Path extends string = string>() {
+  type Route = OneRouter.RouteType<Path>
   type Params = Route['Params']
+  type TypedLoaderProps = LoaderProps<Params>
 
   return {
     useParams: () => useParams<Params>(),
     useActiveParams: () => useActiveParams<Params>(),
-    createLoader: (a: Route['Loader']) => a,
+    /**
+     * Creates a typed loader function for this route.
+     * The loader receives LoaderProps with typed params.
+     *
+     * @example
+     * const route = createRoute<'(site)/docs/[slug]'>()
+     * export const loader = route.createLoader(({ params }) => {
+     *   // params is typed as { slug: string }
+     *   return { doc: getDoc(params.slug) }
+     * })
+     */
+    createLoader: <T>(fn: (props: TypedLoaderProps) => T) => fn,
   }
 }
 

package/src/typed-routes/generateRouteTypes.ts

@@ -1,15 +1,19 @@
 import { writeFile } from 'node:fs/promises'
-import { dirname } from 'node:path'
+import { dirname, join } from 'node:path'
 import FSExtra from 'fs-extra'
 import micromatch from 'micromatch'
 import { globbedRoutesToRouteContext } from '../router/useViteRoutes'
 import { globDir } from '../utils/globDir'
+import type { One } from '../vite/types'
 import { getTypedRoutesDeclarationFile } from './getTypedRoutesDeclarationFile'
+import { injectRouteHelpers, type InjectMode } from './injectRouteHelpers'
+import { removeSupportedExtensions } from '../router/matchers'
 
 export async function generateRouteTypes(
   outFile: string,
   routerRoot: string,
-  ignoredRouteFiles?: string[]
+  ignoredRouteFiles?: string[],
+  typedRoutesMode?: 'type' | 'runtime'
 ) {
   let routePaths = globDir(routerRoot)
   if (ignoredRouteFiles && ignoredRouteFiles.length > 0) {
@@ -27,4 +31,44 @@ export async function generateRouteTypes(
   const outDir = dirname(outFile)
   await FSExtra.ensureDir(outDir)
   await writeFile(outFile, declarations)
+
+  // If experimental.typedRoutesGeneration is enabled, inject helpers into route files
+  if (typedRoutesMode) {
+    const mode: InjectMode = typedRoutesMode === 'type' ? 'type' : 'runtime'
+
+    // Inject helpers into each route file
+    for (const routePath of routePaths) {
+      // Skip non-route files (layouts, middlewares, type definitions, etc.)
+      if (
+        routePath.includes('_layout') ||
+        routePath.includes('+api') ||
+        routePath.startsWith('_') ||
+        routePath.endsWith('.d.ts')
+      ) {
+        continue
+      }
+
+      // Convert route path to route name
+      // e.g., "./app/(site)/docs/[slug]+ssg.tsx" -> "/(site)/docs/[slug]"
+      const fullPath = join(process.cwd(), routerRoot, routePath)
+      const routeName = routePath
+        .replace(/^\.\//, '')
+        .replace(/\+[^/]*$/, '') // Remove +ssg, +ssr, etc.
+        .replace(/\/index$/, '')
+        .replace(/index$/, '')
+      let cleanRouteName = removeSupportedExtensions(routeName).replace(/\/?index$/, '')
+
+      // Ensure leading slash
+      if (!cleanRouteName.startsWith('/')) {
+        cleanRouteName = '/' + cleanRouteName
+      }
+
+      // Skip routes without dynamic segments (no params to type)
+      if (!cleanRouteName.includes('[')) {
+        continue
+      }
+
+      await injectRouteHelpers(fullPath, cleanRouteName, mode)
+    }
+  }
 }

package/src/typed-routes/getTypedRoutesDeclarationFile.ts

@@ -26,6 +26,8 @@ export function getTypedRoutesDeclarationFile(ctx: One.RouteContext) {
     dynamicRouteContextKeys
   )
 
+  const hasRoutes = dynamicRouteContextKeys.size > 0
+
   return `// deno-lint-ignore-file
 /* eslint-disable */
 // biome-ignore: needed import
@@ -38,12 +40,80 @@ declare module 'one' {
       DynamicRoutes: ${setToUnionType(dynamicRoutes)}
       DynamicRouteTemplate: ${setToUnionType(dynamicRouteContextKeys)}
       IsTyped: true
+      ${hasRoutes ? `RouteTypes: ${generateRouteTypesMap(dynamicRouteContextKeys)}` : ''}
     }
   }
 }
+${
+  hasRoutes
+    ? `
+/**
+ * Helper type for route information
+ */
+type RouteInfo<Params = Record<string, never>> = {
+  Params: Params
+  LoaderProps: { path: string; params: Params; request?: Request }
+}`
+    : ''
+}
 `.trim()
 }
 
+/**
+ * Generates a mapped type for all routes with their expanded types
+ * This improves intellisense by showing actual param types instead of aliases
+ */
+function generateRouteTypesMap(dynamicRouteContextKeys: Set<string>): string {
+  if (dynamicRouteContextKeys.size === 0) {
+    return '{}'
+  }
+
+  const routes = [...dynamicRouteContextKeys].sort()
+
+  const entries = routes
+    .map((routePath) => {
+      // Generate the param type inline for better intellisense
+      const params = extractParams(routePath)
+      const paramsType = params.length === 0 ? '{}' : generateInlineParamsType(params)
+
+      return `        '${routePath}': RouteInfo<${paramsType}>`
+    })
+    .join('\n')
+
+  return `{\n${entries}\n      }`
+}
+
+/**
+ * Extract parameter names from a route path
+ * e.g., "/docs/[slug]/[id]" -> ["slug", "id"]
+ */
+function extractParams(routePath: string): Array<{ name: string; isCatchAll: boolean }> {
+  const params: Array<{ name: string; isCatchAll: boolean }> = []
+  const paramRegex = /\[(\.\.\.)?([\w]+)\]/g
+  let match
+
+  while ((match = paramRegex.exec(routePath)) !== null) {
+    params.push({
+      name: match[2],
+      isCatchAll: match[1] === '...',
+    })
+  }
+
+  return params
+}
+
+/**
+ * Generate inline params type for better intellisense
+ * e.g., [{ name: "slug", isCatchAll: false }] -> "{ slug: string }"
+ */
+function generateInlineParamsType(params: Array<{ name: string; isCatchAll: boolean }>): string {
+  const entries = params.map((p) => {
+    const type = p.isCatchAll ? 'string[]' : 'string'
+    return `${p.name}: ${type}`
+  })
+  return `{ ${entries.join('; ')} }`
+}
+
 /**
  * Walks a RouteNode tree and adds the routes to the provided sets
  */