one 1.2.16 → 1.2.17

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/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
  */

package/src/typed-routes/injectRouteHelpers.ts

@@ -0,0 +1,186 @@
+import { readFile, writeFile } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+
+export type InjectMode = 'type' | 'runtime'
+
+/**
+ * Injects route type helpers into a route file if they don't already exist.
+ *
+ * This function:
+ * - Checks if the file already has `type Route` or `const route` declarations
+ * - Adds them if missing with proper spacing (blank line after imports)
+ * - Tries to add imports to existing `import {} from 'one'` statements
+ * - Does NOT modify existing loader code - that's up to the user
+ */
+export async function injectRouteHelpers(
+  filePath: string,
+  routePath: string,
+  mode: InjectMode
+): Promise<boolean> {
+  if (!existsSync(filePath)) {
+    return false
+  }
+
+  try {
+    let content = await readFile(filePath, 'utf-8')
+    let modified = false
+
+    // Check if already has type Route or const route
+    const hasTypeRoute = /^type\s+Route\s*=/m.test(content)
+    const hasConstRoute = /^const\s+route\s*=/m.test(content)
+
+    // If runtime mode and doesn't have const route, add it
+    if (mode === 'runtime' && !hasConstRoute) {
+      const { updatedContent } = addCreateRouteImport(content)
+      content = updatedContent
+
+      // Add const route declaration after imports with blank line before
+      const routeDeclaration = `const route = createRoute<'${routePath}'>()`
+      content = insertAfterImports(content, routeDeclaration)
+      modified = true
+    }
+
+    // If type mode and doesn't have type Route, add it
+    if (mode === 'type' && !hasTypeRoute) {
+      const { updatedContent } = addRouteTypeImport(content)
+      content = updatedContent
+
+      // Add type Route declaration after imports with blank line before
+      const typeDeclaration = `type Route = RouteType<'${routePath}'>`
+      content = insertAfterImports(content, typeDeclaration)
+      modified = true
+    }
+
+    if (modified) {
+      await writeFile(filePath, content, 'utf-8')
+      return true
+    }
+
+    return false
+  } catch (error) {
+    console.error(`Failed to inject route helpers into ${filePath}:`, error)
+    return false
+  }
+}
+
+/**
+ * Adds createRoute to an existing import from 'one', or creates a new import
+ */
+function addCreateRouteImport(content: string): { updatedContent: string; importAdded: boolean } {
+  // Check if already imports createRoute
+  if (/import\s+[^'"]*createRoute[^'"]*from\s+['"]one['"]/m.test(content)) {
+    return { updatedContent: content, importAdded: false }
+  }
+
+  // Try to find existing import from 'one'
+  const oneImportRegex = /import\s+{([^}]*)}\s+from\s+['"]one['"]/m
+  const match = content.match(oneImportRegex)
+
+  if (match) {
+    // Add createRoute to existing import
+    const existingImports = match[1].trim()
+    const newImports = existingImports ? `${existingImports}, createRoute` : 'createRoute'
+    const updatedContent = content.replace(oneImportRegex, `import { ${newImports} } from 'one'`)
+    return { updatedContent, importAdded: true }
+  }
+
+  // No existing import, add a new one after the last import
+  const lastImportIndex = findLastImportIndex(content)
+  if (lastImportIndex >= 0) {
+    const lines = content.split('\n')
+    lines.splice(lastImportIndex + 1, 0, `import { createRoute } from 'one'`)
+    return { updatedContent: lines.join('\n'), importAdded: true }
+  }
+
+  // No imports at all, add at the top
+  const newImport = `import { createRoute } from 'one'\n`
+  return { updatedContent: newImport + content, importAdded: true }
+}
+
+/**
+ * Adds RouteType to an existing type import from 'one', or creates a new import
+ */
+function addRouteTypeImport(content: string): { updatedContent: string; importAdded: boolean } {
+  // Check if already imports RouteType
+  if (/import\s+type\s+[^'"]*RouteType[^'"]*from\s+['"]one['"]/m.test(content)) {
+    return { updatedContent: content, importAdded: false }
+  }
+
+  // Try to find existing type import from 'one'
+  const oneTypeImportRegex = /import\s+type\s+{([^}]*)}\s+from\s+['"]one['"]/m
+  const match = content.match(oneTypeImportRegex)
+
+  if (match) {
+    // Add RouteType to existing import
+    const existingImports = match[1].trim()
+    const newImports = existingImports ? `${existingImports}, RouteType` : 'RouteType'
+    const updatedContent = content.replace(
+      oneTypeImportRegex,
+      `import type { ${newImports} } from 'one'`
+    )
+    return { updatedContent, importAdded: true }
+  }
+
+  // No existing type import, add a new one after the last import
+  const lastImportIndex = findLastImportIndex(content)
+  if (lastImportIndex >= 0) {
+    const lines = content.split('\n')
+    lines.splice(lastImportIndex + 1, 0, `import type { RouteType } from 'one'`)
+    return { updatedContent: lines.join('\n'), importAdded: true }
+  }
+
+  // No imports at all, add at the top
+  const newImport = `import type { RouteType } from 'one'\n`
+  return { updatedContent: newImport + content, importAdded: true }
+}
+
+/**
+ * Finds the index of the last import statement line
+ */
+function findLastImportIndex(content: string): number {
+  const lines = content.split('\n')
+  let lastImportIndex = -1
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim()
+    if (
+      line.startsWith('import ') ||
+      (lastImportIndex >= 0 && (line.startsWith('from ') || line === '}'))
+    ) {
+      lastImportIndex = i
+    } else if (lastImportIndex >= 0 && line && !line.startsWith('//')) {
+      // Stop once we hit non-import code
+      break
+    }
+  }
+
+  return lastImportIndex
+}
+
+/**
+ * Inserts code after the last import statement with proper spacing
+ * Ensures there's a blank line between imports and the inserted code, and after the inserted code
+ */
+function insertAfterImports(content: string, codeToInsert: string): string {
+  const lines = content.split('\n')
+  const lastImportIndex = findLastImportIndex(content)
+
+  if (lastImportIndex >= 0) {
+    // Check if there's already a blank line after imports
+    const nextLine = lines[lastImportIndex + 1]
+    const hasBlankLine = nextLine === ''
+
+    if (hasBlankLine) {
+      // Insert after the blank line with a blank line after
+      lines.splice(lastImportIndex + 2, 0, codeToInsert, '')
+    } else {
+      // Add blank line before and after code
+      lines.splice(lastImportIndex + 1, 0, '', codeToInsert, '')
+    }
+
+    return lines.join('\n')
+  }
+
+  // No imports found, add at the beginning with spacing
+  return codeToInsert + '\n\n' + content
+}

package/src/vite/loadConfig.ts

@@ -15,24 +15,36 @@ function getUserOneOptions() {
   return globalThis.__oneOptions as One.PluginOptions
 }
 
-export async function loadUserOneOptions(command: 'serve' | 'build') {
-  const config = await loadConfigFromFile({
-    mode: command === 'serve' ? 'dev' : 'prod',
-    command,
-  })
-
-  if (!config) {
-    throw new Error(`No config config in ${process.cwd()}. Is this the correct directory?`)
+export async function loadUserOneOptions(command: 'serve' | 'build', silent = false) {
+  // Suppress console output if silent
+  const originalConsoleError = console.error
+  if (silent) {
+    console.error = () => {}
   }
 
-  const oneOptions = getUserOneOptions()
-
-  if (!oneOptions) {
-    throw new Error(`No One plugin config in this vite.config`)
-  }
-
-  return {
-    config,
-    oneOptions,
+  try {
+    const config = await loadConfigFromFile({
+      mode: command === 'serve' ? 'dev' : 'prod',
+      command,
+    })
+
+    if (!config) {
+      throw new Error(`No config config in ${process.cwd()}. Is this the correct directory?`)
+    }
+
+    const oneOptions = getUserOneOptions()
+
+    if (!oneOptions) {
+      throw new Error(`No One plugin config in this vite.config`)
+    }
+
+    return {
+      config,
+      oneOptions,
+    }
+  } finally {
+    if (silent) {
+      console.error = originalConsoleError
+    }
   }
 }

package/src/vite/plugins/generateFileSystemRouteTypesPlugin.tsx

@@ -17,13 +17,19 @@ export function generateFileSystemRouteTypesPlugin(options: One.PluginOptions):
       const outFile = join(appDir, 'routes.d.ts')
 
       const routerRoot = getRouterRootFromOneOptions(options)
+      const typedRoutesGeneration = options.router?.experimental?.typedRoutesGeneration || undefined
 
       // on change ./app stuff lets reload this to pick up any route changes
       const fileWatcherChangeListener = debounce(async (type: string, path: string) => {
-        if (type === 'add' || type === 'delete') {
+        if (type === 'add' || type === 'delete' || type === 'change') {
           if (path.startsWith(appDir)) {
             // generate
-            generateRouteTypes(outFile, routerRoot, options.router?.ignoredRouteFiles)
+            generateRouteTypes(
+              outFile,
+              routerRoot,
+              options.router?.ignoredRouteFiles,
+              typedRoutesGeneration
+            )
           }
         }
       }, 100)
@@ -33,7 +39,12 @@ export function generateFileSystemRouteTypesPlugin(options: One.PluginOptions):
       return () => {
         // once on startup:
 
-        generateRouteTypes(outFile, routerRoot, options.router?.ignoredRouteFiles)
+        generateRouteTypes(
+          outFile,
+          routerRoot,
+          options.router?.ignoredRouteFiles,
+          typedRoutesGeneration
+        )
       }
     },
   } satisfies Plugin

package/src/vite/types.ts

@@ -136,6 +136,32 @@ export namespace One {
          * Currently, this will only effect the `<Slot />` navigator, where it will modify the screen element provided by `react-navigation` and set the `key` to a static value to prevent re-mounting.
          */
         preventLayoutRemounting?: boolean
+
+        /**
+         * Auto-generate route type helpers in route files.
+         *
+         * Route types are always generated in routes.d.ts. This option controls whether
+         * One automatically inserts type helpers into your route files.
+         *
+         * Options:
+         * - `false` (default): No auto-generation, manually add types yourself
+         * - `'type'`: Auto-inserts type-only helpers:
+         *   ```typescript
+         *   import type { RouteType } from 'one'
+         *   type Route = RouteType<'/your/[route]'>
+         *   ```
+         * - `'runtime'`: Auto-inserts runtime helpers:
+         *   ```typescript
+         *   import { createRoute } from 'one'
+         *   const route = createRoute<'/your/[route]'>()
+         *   ```
+         *
+         * The insertion happens automatically when route files are created or modified,
+         * and respects your existing code (won't modify loaders, etc).
+         *
+         * @default false
+         */
+        typedRoutesGeneration?: false | 'type' | 'runtime'
       }
     }
 

package/types/cli/generateRoutes.d.ts

@@ -1,4 +1,5 @@
 export declare function run(args?: {
     appDir?: string;
+    typed?: string;
 }): Promise<void>;
 //# sourceMappingURL=generateRoutes.d.ts.map

package/types/cli/generateRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateRoutes.d.ts","sourceRoot":"","sources":["../../src/cli/generateRoutes.ts"],"names":[],"mappings":"AAIA,wBAAsB,GAAG,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,iBAkBvD"}
+{"version":3,"file":"generateRoutes.d.ts","sourceRoot":"","sources":["../../src/cli/generateRoutes.ts"],"names":[],"mappings":"AAMA,wBAAsB,GAAG,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,iBAgEvE"}

package/types/index.d.ts

@@ -1,10 +1,20 @@
 export { createApp } from './createApp';
 export type { One, OneRouter } from './interfaces/router';
 import type { OneRouter } from './interfaces/router';
-export type Href = OneRouter.Href extends {
-    __branded__: any;
-} ? string : OneRouter.Href;
+export type Href = '__branded__' extends keyof OneRouter.Href ? string : OneRouter.Href;
 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>;
 export { useIsFocused } from '@react-navigation/core';
 export * from '@vxrn/universal-color-scheme';
 export { SafeAreaView } from 'react-native-safe-area-context';

package/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGpD,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,SAAS;IAAE,WAAW,EAAE,GAAG,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAAC,IAAI,CAAA;AAExF,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;AAGlF,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAErD,cAAc,8BAA8B,CAAA;AAI5C,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAG9D,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,SAAS,EACT,WAAW,EACX,sBAAsB,EACtB,SAAS,EACT,WAAW,EACX,qBAAqB,GACtB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,KAAK,WAAW,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,KAAK,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACnG,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGpD,MAAM,MAAM,IAAI,GAAG,aAAa,SAAS,MAAM,SAAS,CAAC,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC,IAAI,CAAA;AAEvF,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;AAElF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,IAAI,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAG/E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAErD,cAAc,8BAA8B,CAAA;AAI5C,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAG9D,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,SAAS,EACT,WAAW,EACX,sBAAsB,EACtB,SAAS,EACT,WAAW,EACX,qBAAqB,GACtB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,KAAK,WAAW,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,KAAK,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACnG,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA"}

package/types/interfaces/router.d.ts

@@ -13,6 +13,22 @@ export declare namespace OneRouter {
             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;