one 1.2.57 → 1.2.58

package/src/vite/one.ts

@@ -22,6 +22,7 @@ import { createFileSystemRouterPlugin } from './plugins/fileSystemRouterPlugin'
 import { fixDependenciesPlugin } from './plugins/fixDependenciesPlugin'
 import { generateFileSystemRouteTypesPlugin } from './plugins/generateFileSystemRouteTypesPlugin'
 import { imageDataPlugin } from './plugins/imageDataPlugin'
+import { sourceInspectorPlugin } from './plugins/sourceInspectorPlugin'
 import { SSRCSSPlugin } from './plugins/SSRCSSPlugin'
 import { virtualEntryId } from './plugins/virtualEntryConstants'
 import { createVirtualEntry } from './plugins/virtualEntryPlugin'
@@ -678,5 +679,17 @@ export function one(options: One.PluginOptions = {}): PluginOption {
     SSRCSSPlugin({
       entries: [virtualEntryId],
     }),
+
+    // Source inspector - show source file location on hover with Shift+Ctrl/Cmd
+    ...(() => {
+      // devtools defaults to true
+      const devtools = options.devtools ?? true
+      if (devtools === false) return []
+
+      // if devtools is true, enable all tools
+      // if devtools is object, check individual settings (default true)
+      const inspector = devtools === true || (devtools.inspector ?? true)
+      return inspector ? sourceInspectorPlugin() : []
+    })(),
   ]
 }

package/src/vite/plugins/SSRCSSPlugin.ts

@@ -3,6 +3,11 @@ import { VIRTUAL_SSR_CSS_ENTRY, VIRTUAL_SSR_CSS_HREF } from '../../constants'
 
 // thanks to hi-ogawa https://github.com/hi-ogawa/vite-plugins/tree/main/packages/ssr-css
 
+// Track if we've pre-warmed routes and cached CSS
+let cssCache: { css: string; timestamp: number } | null = null
+let routesPreWarmed = false
+const CSS_CACHE_TTL = 1000 // 1 second cache for dev mode
+
 export function SSRCSSPlugin(pluginOpts: { entries: string[] }): Plugin {
   let server: ViteDevServer
 
@@ -12,12 +17,64 @@ export function SSRCSSPlugin(pluginOpts: { entries: string[] }): Plugin {
     configureServer(server_) {
       server = server_
 
+      // Pre-warm route modules on first request to populate the module graph
+      // This ensures CSS from all routes is collected even for lazy imports
+      const preWarmRoutes = async () => {
+        if (routesPreWarmed) return
+        routesPreWarmed = true
+
+        try {
+          // Transform the virtual entry to get route module paths
+          await server.transformRequest(pluginOpts.entries[0])
+
+          // Get all route files from the module graph
+          const routeFiles = await collectRouteFiles(server, pluginOpts.entries)
+
+          // Transform each route file to warm its CSS dependencies
+          await Promise.all(
+            routeFiles.map((file) =>
+              server.transformRequest(file).catch(() => {
+                // Ignore errors - some routes may have issues
+              })
+            )
+          )
+
+          if (process.env.ONE_DEBUG) {
+            console.log(
+              `[one] Pre-warmed ${routeFiles.length} route modules for CSS collection`
+            )
+          }
+        } catch (err) {
+          console.error('[one] Error pre-warming routes:', err)
+        }
+      }
+
+      // Invalidate CSS cache on HMR
+      server.watcher.on('change', () => {
+        cssCache = null
+      })
+
       // invalidate virtual modules for each direct request
       server.middlewares.use(async (req, res, next) => {
         if (req.url?.includes(VIRTUAL_SSR_CSS_HREF)) {
+          // Pre-warm routes on first CSS request
+          await preWarmRoutes()
+
           invalidateModule(server, '\0' + VIRTUAL_SSR_CSS_ENTRY + '?direct')
 
+          // Use cached CSS if fresh
+          const now = Date.now()
+          if (cssCache && now - cssCache.timestamp < CSS_CACHE_TTL) {
+            res.setHeader('Content-Type', 'text/css')
+            res.setHeader('Cache-Control', 'no-store')
+            res.setHeader('Vary', '*')
+            res.write(cssCache.css)
+            res.end()
+            return
+          }
+
           const code = await collectStyle(server, pluginOpts.entries)
+          cssCache = { css: code, timestamp: now }
 
           res.setHeader('Content-Type', 'text/css')
           res.setHeader('Cache-Control', 'no-store')
@@ -175,3 +232,50 @@ async function collectStyleUrls(
 
 // cf. https://github.com/vitejs/vite/blob/d6bde8b03d433778aaed62afc2be0630c8131908/packages/vite/src/node/constants.ts#L49C23-L50
 const CSS_LANGS_RE = /\.(css|less|sass|scss|styl|stylus|pcss|postcss|sss)(?:$|\?)/
+
+// Match route files from dynamic imports in virtual entry
+// Vite transforms import.meta.glob to:
+// const routes = { "./path/to/file.tsx": () => import("./path/to/file.tsx") }
+const DYNAMIC_IMPORT_RE = /import\s*\(\s*["'`]([^"'`]+)["'`]\s*\)/g
+
+/**
+ * Collect all route file paths from the module graph.
+ * This is used to pre-warm route modules so their CSS is included.
+ */
+async function collectRouteFiles(
+  server: ViteDevServer,
+  entries: string[]
+): Promise<string[]> {
+  const routeFiles: string[] = []
+
+  for (const entry of entries) {
+    try {
+      // Get the transformed code for the entry
+      const result = await server.transformRequest(entry)
+      if (!result?.code) continue
+
+      // Extract dynamic import paths from the transformed code
+      let match
+      while ((match = DYNAMIC_IMPORT_RE.exec(result.code)) !== null) {
+        const importPath = match[1]
+        // Only include actual route files, not node_modules or virtual
+        if (
+          importPath &&
+          !importPath.includes('node_modules') &&
+          !importPath.startsWith('\0') &&
+          !importPath.startsWith('virtual:') &&
+          (importPath.endsWith('.tsx') ||
+            importPath.endsWith('.ts') ||
+            importPath.endsWith('.jsx') ||
+            importPath.endsWith('.js'))
+        ) {
+          routeFiles.push(importPath)
+        }
+      }
+    } catch {
+      // Ignore errors
+    }
+  }
+
+  return routeFiles
+}

package/src/vite/plugins/fileSystemRouterPlugin.tsx

@@ -360,15 +360,18 @@ export function createFileSystemRouterPlugin(options: One.PluginOptions): Plugin
       const appDir = path.join(process.cwd(), getRouterRootFromOneOptions(options))
 
       // on change ./app stuff lets reload this to pick up any route changes
-      const fileWatcherChangeListener = debounce(async (type: string, changedPath: string) => {
-        if (type === 'add' || type === 'delete') {
-          // resolve to absolute path since watcher may emit relative paths
-          const absolutePath = path.resolve(changedPath)
-          if (absolutePath.startsWith(appDir)) {
-            handleRequest = createRequestHandler()
+      const fileWatcherChangeListener = debounce(
+        async (type: string, changedPath: string) => {
+          if (type === 'add' || type === 'delete') {
+            // resolve to absolute path since watcher may emit relative paths
+            const absolutePath = path.resolve(changedPath)
+            if (absolutePath.startsWith(appDir)) {
+              handleRequest = createRequestHandler()
+            }
           }
-        }
-      }, 100)
+        },
+        100
+      )
 
       server.watcher.addListener('all', fileWatcherChangeListener)
 

package/src/vite/plugins/generateFileSystemRouteTypesPlugin.tsx

@@ -25,6 +25,10 @@ export function generateFileSystemRouteTypesPlugin(options: One.PluginOptions):
         if (type === 'add' || type === 'delete' || type === 'change') {
           // resolve to absolute path since watcher may emit relative paths
           const absolutePath = resolve(path)
+          // skip routes.d.ts itself to avoid infinite loop
+          if (absolutePath === outFile) {
+            return
+          }
           if (absolutePath.startsWith(appDir)) {
             // generate
             generateRouteTypes(

package/src/vite/plugins/sourceInspectorPlugin.ts

@@ -0,0 +1,246 @@
+import path from 'node:path'
+import { parseSync } from 'oxc-parser'
+import { normalizePath } from 'vite'
+import type { Plugin, ViteDevServer } from 'vite'
+
+interface JsxLocation {
+  /** Position right after the tag name where we insert the attribute */
+  insertOffset: number
+  /** Traversal index - stable ordering that's the same on server and client */
+  index: number
+  /** Actual line number for editor navigation */
+  line: number
+  /** Actual column number for editor navigation */
+  column: number
+}
+
+/**
+ * Parse code with oxc and find all JSX opening elements.
+ * Returns insertion points sorted by offset (descending for safe insertion).
+ */
+function findJsxElements(code: string, filename: string): JsxLocation[] {
+  const result = parseSync(filename, code)
+
+  if (result.errors.length > 0) {
+    return []
+  }
+
+  const locations: JsxLocation[] = []
+  let traversalIndex = 0
+
+  function getJsxName(node: any): string | null {
+    if (!node) return null
+    if (node.type === 'JSXIdentifier') return node.name
+    if (node.type === 'JSXMemberExpression') {
+      const obj = getJsxName(node.object)
+      return obj ? `${obj}.${node.property?.name}` : null
+    }
+    return null
+  }
+
+  function getLocation(offset: number): { line: number; column: number } {
+    const before = code.slice(0, offset)
+    const lines = before.split('\n')
+    return {
+      line: lines.length,
+      column: lines[lines.length - 1]!.length + 1,
+    }
+  }
+
+  function walk(node: any): void {
+    if (!node || typeof node !== 'object') return
+
+    if (node.type === 'JSXOpeningElement' && node.name) {
+      const tagName = getJsxName(node.name)
+
+      // Skip Fragment and already-tagged elements
+      if (tagName && tagName !== 'Fragment') {
+        // Check if already has data-one-source
+        const hasSourceAttr = node.attributes?.some(
+          (attr: any) =>
+            attr.type === 'JSXAttribute' && attr.name?.name === 'data-one-source'
+        )
+
+        if (!hasSourceAttr) {
+          // Insert position is right after the tag name
+          const nameEnd = node.name.end
+          const loc = getLocation(node.start)
+
+          locations.push({
+            insertOffset: nameEnd,
+            index: traversalIndex++,
+            line: loc.line,
+            column: loc.column,
+          })
+        }
+      }
+    }
+
+    // Walk all child nodes in consistent order
+    for (const key of Object.keys(node)) {
+      if (key === 'parent') continue
+      const value = node[key]
+      if (Array.isArray(value)) {
+        for (const child of value) {
+          walk(child)
+        }
+      } else if (value && typeof value === 'object') {
+        walk(value)
+      }
+    }
+  }
+
+  walk(result.program)
+
+  // Sort by offset descending so we can insert from end to start without shifting positions
+  return locations.sort((a, b) => b.insertOffset - a.insertOffset)
+}
+
+/**
+ * Transforms JSX to inject data-one-source attributes using oxc-parser.
+ * Uses stable traversal indices instead of line numbers to avoid hydration mismatches.
+ */
+function injectSourceToJsx(
+  code: string,
+  id: string
+): { code: string; map?: null } | undefined {
+  const [filePath] = id.split('?')
+  if (!filePath) return
+
+  const location = filePath.replace(normalizePath(process.cwd()), '')
+
+  // Quick check - skip if no JSX-like content
+  if (!code.includes('<') || !code.includes('>')) {
+    return
+  }
+
+  const jsxLocations = findJsxElements(code, filePath)
+
+  if (jsxLocations.length === 0) {
+    return
+  }
+
+  // Build source info map for this file
+  // Sort by index (ascending) for the map, since jsxLocations is sorted by offset (descending)
+  const sourceInfoEntries = [...jsxLocations]
+    .sort((a, b) => a.index - b.index)
+    .map((jsx) => `${jsx.index}:[${jsx.line},${jsx.column}]`)
+    .join(',')
+
+  // Inject source info registration at the top of the file
+  const sourceInfoScript = `globalThis.__oneSourceInfo=globalThis.__oneSourceInfo||{};globalThis.__oneSourceInfo["${location}"]={${sourceInfoEntries}};`
+
+  let result = code
+
+  // Insert from end to start to preserve offsets
+  for (const jsx of jsxLocations) {
+    // Use stable index instead of line:column
+    const sourceAttr = ` data-one-source="${location}:${jsx.index}"`
+    result =
+      result.slice(0, jsx.insertOffset) + sourceAttr + result.slice(jsx.insertOffset)
+  }
+
+  // Add source info at the very beginning of the file
+  result = sourceInfoScript + result
+
+  return { code: result, map: null }
+}
+
+async function openInEditor(
+  filePath: string,
+  line?: string,
+  column?: string
+): Promise<void> {
+  try {
+    const launch = (await import('launch-editor')).default
+    const fullPath = path.join(process.cwd(), filePath)
+    const location = `${fullPath}${line ? `:${line}` : ''}${column ? `:${column}` : ''}`
+
+    launch(location, undefined, (filename: string, errorMessage: string | null) => {
+      if (errorMessage) {
+        console.warn(
+          `[one:source-inspector] Failed to open ${filename} in editor:`,
+          errorMessage
+        )
+      }
+    })
+  } catch (err) {
+    console.warn('[one:source-inspector] Failed to launch editor:', err)
+  }
+}
+
+export function sourceInspectorPlugin(): Plugin[] {
+  return [
+    // Transform plugin - injects data-one-source attributes
+    {
+      name: 'one:source-inspector-transform',
+      enforce: 'pre',
+      apply: 'serve',
+
+      transform(code, id) {
+        const envName = this.environment?.name
+        // Skip native environments only - transform both client and SSR for consistency
+        if (envName === 'ios' || envName === 'android') return
+
+        if (
+          id.includes('node_modules') ||
+          id.includes('?raw') ||
+          id.includes('dist') ||
+          id.includes('build')
+        ) {
+          return
+        }
+
+        if (!id.endsWith('.jsx') && !id.endsWith('.tsx')) return
+
+        return injectSourceToJsx(code, id)
+      },
+    },
+
+    // Note: Inspector UI script is now injected via DevHead.tsx for SSR compatibility
+
+    // Server plugin - handles open-source requests
+    {
+      name: 'one:source-inspector-server',
+      apply: 'serve',
+
+      configureServer(server: ViteDevServer) {
+        server.middlewares.use(async (req, res, next) => {
+          if (!req.url?.startsWith('/__one/open-source')) {
+            return next()
+          }
+
+          try {
+            const url = new URL(req.url, 'http://localhost')
+            const source = url.searchParams.get('source')
+
+            if (!source) {
+              res.statusCode = 400
+              res.end('Missing source parameter')
+              return
+            }
+
+            // Parse the source - now format is "filePath:index"
+            const lastColon = source.lastIndexOf(':')
+            const filePath = source.slice(0, lastColon)
+            const index = source.slice(lastColon + 1)
+
+            // Look up actual line/column from source info
+            // The client will send these if available
+            const line = url.searchParams.get('line')
+            const column = url.searchParams.get('column')
+
+            await openInEditor(filePath, line || undefined, column || undefined)
+
+            res.statusCode = 200
+            res.end('OK')
+          } catch (err) {
+            console.error('[one:source-inspector] Error:', err)
+            res.statusCode = 500
+            res.end('Internal server error')
+          }
+        })
+      },
+    },
+  ]
+}

package/src/vite/plugins/virtualEntryPlugin.ts

@@ -56,11 +56,20 @@ function normalizeSetupFile(
   }
 }
 
+type SetupImportResult = {
+  /** Import statement to prepend (for native static imports) */
+  importStatement: string
+  /** Variable declaration for setup promise (for web dynamic imports) */
+  promiseDeclaration: string
+  /** The variable name to pass to createApp, or empty if no setup */
+  promiseVarName: string
+}
+
 function getSetupFileImport(
   environmentName: string,
   setupFiles: NormalizedSetupFiles,
   useStaticImport: boolean
-): string {
+): SetupImportResult {
   const envMap: Record<string, keyof NormalizedSetupFiles> = {
     client: 'client',
     ssr: 'server',
@@ -69,18 +78,28 @@ function getSetupFileImport(
   }
 
   const key = envMap[environmentName]
-  if (!key) return ''
+  if (!key) return { importStatement: '', promiseDeclaration: '', promiseVarName: '' }
 
   const setupFile = setupFiles[key]
-  if (!setupFile) return ''
+  if (!setupFile) return { importStatement: '', promiseDeclaration: '', promiseVarName: '' }
 
   // For native, use static import since dynamic import doesn't work
-  // For web, use top-level await with dynamic import to ensure setup runs before app
   if (useStaticImport) {
-    return `import ${JSON.stringify(setupFile)}`
+    return {
+      importStatement: `import ${JSON.stringify(setupFile)}`,
+      promiseDeclaration: '',
+      promiseVarName: '',
+    }
   }
 
-  return `await import(/* @vite-ignore */ ${JSON.stringify(setupFile)})`
+  // For web, use non-blocking dynamic import to avoid circular dependency deadlocks
+  // when the setup file's dependencies use Vite's __vite_preload helper.
+  // The promise is passed to createApp which awaits it before rendering.
+  return {
+    importStatement: '',
+    promiseDeclaration: `const __oneSetupPromise = import(/* @vite-ignore */ ${JSON.stringify(setupFile)})`,
+    promiseVarName: '__oneSetupPromise',
+  }
 }
 
 export function createVirtualEntry(options: {
@@ -117,7 +136,7 @@ export function createVirtualEntry(options: {
     load(id) {
       if (id === resolvedVirtualEntryId) {
         const isNative = isNativeEnvironment(this.environment)
-        const prependCode = getSetupFileImport(
+        const setupResult = getSetupFileImport(
           this.environment.name,
           setupFiles,
           isNative
@@ -126,8 +145,13 @@ export function createVirtualEntry(options: {
         const nativewindImport = configuration.enableNativewind
           ? `import 'react-native-css-interop/dist/runtime/components'`
           : ''
+        // For web, pass setupPromise to createApp so it awaits before rendering
+        const setupPromiseArg = setupResult.promiseVarName
+          ? `setupPromise: ${setupResult.promiseVarName},`
+          : ''
         return `
-${prependCode}
+${setupResult.importStatement}
+${setupResult.promiseDeclaration}
 ${nativewindImport}
 
 import { createApp, registerPreloadedRoute as _registerPreloadedRoute } from 'one'
@@ -145,6 +169,7 @@ if (typeof window !== 'undefined') {
 
 // globbing ${JSON.stringify(routeGlobs)}
 export default createApp({
+  ${setupPromiseArg}
   routes: import.meta.glob(${JSON.stringify([...routeGlobs, ...ROUTE_WEB_EXCLUSION_GLOB_PATTERNS.map((p) => `!${p}`)])}, { exhaustive: true }),
   routerRoot: ${JSON.stringify(options.root)},
   flags: ${JSON.stringify(options.flags)},
@@ -154,13 +179,13 @@ export default createApp({
 
       if (id === resolvedVirtualEntryIdNative) {
         const isNative = isNativeEnvironment(this.environment)
-        const prependCode = getSetupFileImport(
+        const setupResult = getSetupFileImport(
           this.environment.name,
           setupFiles,
           isNative
         )
         return `
-${prependCode}
+${setupResult.importStatement}
 
 import { createApp } from 'one'
 

package/src/vite/types.ts

@@ -394,6 +394,34 @@ export namespace One {
       sitemap?: boolean | SitemapOptions
     }
 
+    /**
+     * Development tools configuration. Set to `true` to enable all devtools,
+     * `false` to disable, or an object to configure individual tools.
+     *
+     * @default true
+     */
+    devtools?:
+      | boolean
+      | {
+          /**
+           * Enable the source inspector.
+           * Hold Shift+Ctrl (or Shift+Cmd on Mac) and hover over elements
+           * to see their source file location. Click to open in your editor.
+           *
+           * @default true (when devtools is enabled)
+           */
+          inspector?: boolean
+
+          /**
+           * Enable the SEO preview panel.
+           * Press Alt+S to toggle a panel showing how the page appears in
+           * Google search results, Twitter cards, and Open Graph shares.
+           *
+           * @default true (when devtools is enabled)
+           */
+          seoPreview?: boolean
+        }
+
     server?: VXRNOptions['server']
 
     build?: {

package/types/Route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Route.d.ts","sourceRoot":"","sources":["../src/Route.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAc,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEvC,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAEnF,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAA;IACvD,OAAO,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,CAAA;IAClC,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;KAC3C,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAA;IACzC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;KAC3C,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,4BAA4B;IAC5B,IAAI,EAAE,GAAG,CAAC,SAAS,CAAA;IACnB,kEAAkE;IAClE,SAAS,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAA;IACrC,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,oBAAoB;IACpB,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,kCAAkC;IAClC,OAAO,EAAE,IAAI,GAAG,iBAAiB,EAAE,CAAA;IACnC,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAA;IAClB,sBAAsB;IACtB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,oLAAoL;IACpL,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,qBAAqB;IACrB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA;CACtB,CAAA;AAQD,+DAA+D;AAC/D,wBAAgB,YAAY,IAAI,SAAS,GAAG,IAAI,CAE/C;AAED,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAED,iEAAiE;AACjE,wBAAgB,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,2CAEjF"}

package/types/cleanUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanUrl.d.ts","sourceRoot":"","sources":["../src/cleanUrl.ts"],"names":[],"mappings":"AAqBA,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,UAEjD;AAED,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EAEnB,UAAU,UAAW,UAWtB;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,UAKvD"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAGA,wBAAsB,GAAG,CAAC,IAAI,EAAE;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,CAAA;CACpC,iBAkCA"}

package/types/createApp.d.ts

@@ -5,6 +5,11 @@ export type CreateAppProps = {
     routes: Record<string, () => Promise<unknown>>;
     routerRoot: string;
     flags?: One.Flags;
+    /**
+     * Promise that resolves when the setup file has finished loading.
+     * The app will wait for this before rendering to ensure setup code runs first.
+     */
+    setupPromise?: Promise<unknown>;
 };
 export declare function createApp(options: CreateAppProps): Promise<void> | {
     options: CreateAppProps;

package/types/createApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createApp.d.ts","sourceRoot":"","sources":["../src/createApp.tsx"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAA;AAQhB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAM7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEvC,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;IAC9C,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,GAAG,CAAC,KAAK,CAAA;CAClB,CAAA;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc;;oBAIrB,cAAc;EAmJzC"}
+{"version":3,"file":"createApp.d.ts","sourceRoot":"","sources":["../src/createApp.tsx"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAA;AAQhB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAM7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEvC,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;IAC9C,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,GAAG,CAAC,KAAK,CAAA;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CAChC,CAAA;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc;;oBAIrB,cAAc;EAwJzC"}

package/types/createRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRoute.d.ts","sourceRoot":"","sources":["../src/createRoute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD,wBAAgB,WAAW,CAAC,IAAI;;;;;;;;EAS/B;AAkBD,QAAA,MAAM,WAAW;;;;;;;;CAA8B,CAAA;AAE/C,eAAO,MAAM,KAAK,EAAiB;IACjC,IAAI,EAAE;QACJ,GAAG,EAAE,OAAO,WAAW,CAAA;KACxB,CAAA;IACD,aAAa,EAAE,EAAE,CAAA;IACjB,OAAO,EAAE,EAAE,CAAA;CACZ,CAAA"}

package/types/devtools/registry.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Simple registry for devtools functions.
+ * This avoids circular dependencies by letting modules register their
+ * devtools functions instead of router.ts importing them.
+ */
+type DevtoolsRegistry = {
+    getLoaderTimingHistory?: () => any[];
+};
+export declare const devtoolsRegistry: DevtoolsRegistry;
+/**
+ * Register a devtools function. Called by modules like useLoader.ts
+ */
+export declare function registerDevtoolsFunction<K extends keyof DevtoolsRegistry>(key: K, fn: DevtoolsRegistry[K]): void;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/types/devtools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/devtools/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,KAAK,gBAAgB,GAAG;IACtB,sBAAsB,CAAC,EAAE,MAAM,GAAG,EAAE,CAAA;CACrC,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,gBAAqB,CAAA;AAEpD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACvE,GAAG,EAAE,CAAC,EACN,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,QAGxB"}

package/types/fork/NavigationContainer.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationContainer.native.d.ts","sourceRoot":"","sources":["../../src/fork/NavigationContainer.native.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAM5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,cAAc,EACnB,KAAK,KAAK,EAEX,MAAM,0BAA0B,CAAA;AAIjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,KAAK,KAAK,CAAC,SAAS,SAAS,MAAM,IAAI,wBAAwB,GAAG;IAChE,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;IACnC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,aAAa,CAAC,EAAE,oBAAoB,CAAA;IACpC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB,CAAA;AAuGD,QAAA,MAAM,mBAAmB,EAAiD,CACxE,aAA4D,SAAtC,MAAM,GAAG,eAAe,CAAC,aAAa,EAE5D,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG;IAC5B,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,CAAA;CACvD,KACE,KAAK,CAAC,YAAY,CAAA;AAEvB,eAAe,mBAAmB,CAAA"}

package/types/fork/createMemoryHistory.d.ts

@@ -5,13 +5,16 @@
  * Please refrain from making changes to this file, as it will make merging updates from the upstream harder.
  * All modifications except formatting should be marked with `// @modified` comment.
  *
- * No modifications currently, copied only in order to use a custom `useLinking` function.
+ * Modifications:
+ * - Added displayPath field to HistoryRecord for route masking support
+ * - Modified push() and replace() to accept displayPath parameter for showing masked URLs in browser
  */
 import type { NavigationState } from '@react-navigation/core';
 type HistoryRecord = {
     id: string;
     state: NavigationState;
     path: string;
+    displayPath?: string;
 };
 export declare function createMemoryHistory(): {
     readonly index: number;
@@ -19,13 +22,15 @@ export declare function createMemoryHistory(): {
     backIndex({ path }: {
         path: string;
     }): number;
-    push({ path, state }: {
+    push({ path, state, displayPath, }: {
         path: string;
         state: NavigationState;
+        displayPath?: string;
     }): void;
-    replace({ path, state }: {
+    replace({ path, state, displayPath, }: {
         path: string;
         state: NavigationState;
+        displayPath?: string;
     }): void;
     go(n: number): Promise<void> | undefined;
     listen(listener: () => void): () => void;