one 1.2.39 → 1.2.40

package/src/cli/build.ts

@@ -385,7 +385,8 @@ export async function build(args: {
       return []
     })()
 
-    const preloads = [
+    // All preloads combined (original behavior)
+    const allPreloads = [
       ...new Set([
         ...preloadSetupFilePreloads,
         // add the route entry js (like ./app/index.ts)
@@ -395,9 +396,42 @@ export async function build(args: {
         ...entryImports,
         ...layoutImports,
       ]),
-    ]
-      // nested path pages need to reference root assets
-      .map((path) => `/${path}`)
+    ].map((path) => `/${path}`)
+
+    // Check experimental script loading mode
+    const scriptLoadingMode = oneOptions.web?.experimental_scriptLoading
+
+    // Modes that need separated critical/deferred preloads
+    const useDeferredLoading = scriptLoadingMode === 'defer-non-critical'
+    const useAggressiveLCP = scriptLoadingMode === 'after-lcp-aggressive'
+    const needsSeparatedPreloads = useDeferredLoading || useAggressiveLCP
+
+    // Critical: scripts that must execute immediately (entry points, layouts)
+    const criticalPreloads = needsSeparatedPreloads
+      ? [
+          ...new Set([
+            ...preloadSetupFilePreloads,
+            // add the virtual entry (framework bootstrap)
+            vxrnOutput.clientManifest['virtual:one-entry'].file,
+            // add the route entry js (like ./app/index.ts)
+            clientManifestEntry.file,
+            // add layout files (but not their deep imports)
+            ...layoutEntries.map((entry) => entry.file),
+          ]),
+        ].map((path) => `/${path}`)
+      : undefined
+
+    // Non-critical: component imports, utilities - will be modulepreload hints only
+    const deferredPreloads = needsSeparatedPreloads
+      ? [...new Set([...entryImports, ...layoutEntries.flatMap((entry) => collectImports(entry))])]
+          .filter((path) => !criticalPreloads!.includes(`/${path}`))
+          .map((path) => `/${path}`)
+      : undefined
+
+    // Use all preloads when not using deferred loading
+    const preloads = needsSeparatedPreloads
+      ? [...criticalPreloads!, ...deferredPreloads!]
+      : allPreloads
 
     const allEntries = [clientManifestEntry, ...layoutEntries]
     const allCSS = allEntries
@@ -471,9 +505,19 @@ export async function build(args: {
     // Get route-level sitemap export if present
     const routeSitemapExport = exported.sitemap as One.RouteSitemap | undefined
 
+    // Determine if after-lcp script loading should be used for this route
+    // Only applies to SSG pages (SPA pages need JS to render anything)
+    const isAfterLCPMode =
+      scriptLoadingMode === 'after-lcp' || scriptLoadingMode === 'after-lcp-aggressive'
+    const useAfterLCP = foundRoute.type === 'ssg' && isAfterLCPMode
+    const useAfterLCPAggressive =
+      foundRoute.type === 'ssg' && scriptLoadingMode === 'after-lcp-aggressive'
+
     for (const params of paramsList) {
       const path = getPathnameFromFilePath(relativeId, params, foundRoute.type === 'ssg')
-      console.info(`  ↦ route ${path}`)
+      console.info(
+        `  ↦ route ${path}${useAfterLCPAggressive ? ' (after-lcp-aggressive)' : useAfterLCP ? ' (after-lcp)' : ''}`
+      )
 
       const built = await runWithAsyncLocalContext(async () => {
         return await buildPage(
@@ -490,7 +534,11 @@ export async function build(args: {
           preloads,
           allCSS,
           routePreloads,
-          allCSSContents
+          allCSSContents,
+          criticalPreloads,
+          deferredPreloads,
+          useAfterLCP,
+          useAfterLCPAggressive
         )
       })
 

package/src/cli/buildPage.ts

@@ -23,7 +23,11 @@ export async function buildPage(
   preloads: string[],
   allCSS: string[],
   routePreloads: Record<string, string>,
-  allCSSContents?: string[]
+  allCSSContents?: string[],
+  criticalPreloads?: string[],
+  deferredPreloads?: string[],
+  useAfterLCP?: boolean,
+  useAfterLCPAggressive?: boolean
 ): Promise<One.RouteBuildInfo> {
   const render = await getRender(serverEntry)
   const htmlPath = `${path.endsWith('/') ? `${removeTrailingSlash(path)}/index` : path}.html`
@@ -65,13 +69,19 @@ export async function buildPage(
     await FSExtra.writeFile(join(clientDir, preloadPath), preloadContent)
 
     // Generate CSS preload file with prefetch (on hover) and inject (on navigation) functions
+    // Deduplicate CSS URLs to avoid loading the same file multiple times
+    const uniqueCSS = [...new Set(allCSS)]
     const cssPreloadContent = `
 const CSS_TIMEOUT = 1000
-const cssUrls = ${JSON.stringify(allCSS)}
+const cssUrls = ${JSON.stringify(uniqueCSS)}
+
+// Global cache for loaded CSS - avoids DOM queries and tracks across navigations
+const loaded = (window.__oneLoadedCSS ||= new Set())
 
 // Prefetch CSS without applying - called on link hover
 export function prefetchCSS() {
   cssUrls.forEach(href => {
+    if (loaded.has(href)) return
     if (document.querySelector(\`link[href="\${href}"]\`)) return
     const link = document.createElement('link')
     link.rel = 'prefetch'
@@ -84,21 +94,31 @@ export function prefetchCSS() {
 // Inject CSS to apply styles - called on actual navigation
 export function injectCSS() {
   return Promise.all(cssUrls.map(href => {
+    // Skip if already loaded
+    if (loaded.has(href)) return Promise.resolve()
     // Remove any prefetch link for this href
     const prefetchLink = document.querySelector(\`link[rel="prefetch"][href="\${href}"]\`)
     if (prefetchLink) prefetchLink.remove()
-    // Skip if stylesheet already exists
-    if (document.querySelector(\`link[rel="stylesheet"][href="\${href}"]\`)) return Promise.resolve()
+    // Skip if stylesheet already exists in DOM
+    if (document.querySelector(\`link[rel="stylesheet"][href="\${href}"]\`)) {
+      loaded.add(href)
+      return Promise.resolve()
+    }
     return new Promise(resolve => {
       const link = document.createElement('link')
       link.rel = 'stylesheet'
       link.href = href
-      link.onload = link.onerror = resolve
-      document.head.appendChild(link)
-      setTimeout(() => {
+      const timeoutId = setTimeout(() => {
         console.warn('[one] CSS load timeout:', href)
+        loaded.add(href)
         resolve()
       }, CSS_TIMEOUT)
+      link.onload = link.onerror = () => {
+        clearTimeout(timeoutId)
+        loaded.add(href)
+        resolve()
+      }
+      document.head.appendChild(link)
     })
   }))
 }
@@ -134,9 +154,16 @@ if (typeof document === 'undefined') globalThis.document = {}
       globalThis['__vxrnresetState']?.()
 
       if (foundRoute.type === 'ssg') {
-        const html = await render({
+        // Aggressive mode: only modulepreload critical scripts, skip deferred to prevent network saturation
+        // Regular after-lcp mode: modulepreload all scripts for parallel downloads, defer execution
+        // Default: all scripts load normally
+        const renderPreloads = criticalPreloads || preloads
+        const renderDeferredPreloads = useAfterLCPAggressive ? [] : deferredPreloads
+
+        let html = await render({
           path,
-          preloads,
+          preloads: renderPreloads,
+          deferredPreloads: renderDeferredPreloads,
           loaderProps,
           loaderData,
           css: allCSS,
@@ -144,6 +171,13 @@ if (typeof document === 'undefined') globalThis.document = {}
           mode: 'ssg',
           routePreloads,
         })
+
+        // Apply after-LCP script loading if enabled
+        // Load all preloads (not just critical) to ensure good TTI after first paint
+        if (useAfterLCP) {
+          html = applyAfterLCPScriptLoad(html, preloads)
+        }
+
         await outputFile(htmlOutPath, html)
       } else if (foundRoute.type === 'spa') {
         // Generate CSS - either inline styles or link tags
@@ -154,13 +188,22 @@ if (typeof document === 'undefined') globalThis.document = {}
               .join('\n')
           : allCSS.map((file) => `    <link rel="stylesheet" href=${file} />`).join('\n')
 
+        // Use separated preloads if available
+        const criticalScripts = (criticalPreloads || preloads)
+          .map((preload) => `   <script type="module" src="${preload}"></script>`)
+          .join('\n')
+
+        // Non-critical scripts as modulepreload hints only
+        const deferredLinks = (deferredPreloads || [])
+          .map((preload) => `   <link rel="modulepreload" fetchPriority="low" href="${preload}"/>`)
+          .join('\n')
+
         await outputFile(
           htmlOutPath,
           `<html><head>
           ${constants.getSpaHeaderElements({ serverContext: { loaderProps, loaderData } })}
-          ${preloads
-            .map((preload) => `   <script type="module" src="${preload}"></script>`)
-            .join('\n')}
+          ${criticalScripts}
+          ${deferredLinks}
           ${cssOutput}
         </head></html>`
         )
@@ -202,6 +245,8 @@ params:\n\n${JSON.stringify(params || null, null, 2)}`
     params,
     path,
     preloads,
+    criticalPreloads,
+    deferredPreloads,
   }
 }
 
@@ -234,3 +279,50 @@ async function getRender(serverEntry: string) {
 function removeTrailingSlash(path: string) {
   return path.endsWith('/') ? path.slice(0, path.length - 1) : path
 }
+
+/**
+ * Transforms HTML to delay script execution until after first paint.
+ * Keeps modulepreload links so critical scripts download in parallel.
+ * Removes async script tags and adds a loader that executes scripts after paint.
+ */
+function applyAfterLCPScriptLoad(html: string, preloads: string[]): string {
+  // Remove all <script type="module" ... async> tags (prevents immediate execution)
+  // Keep modulepreload links so critical scripts download in parallel
+  html = html.replace(/<script\s+type="module"[^>]*async[^>]*><\/script>/gi, '')
+
+  // Create the loader script
+  // Nested setTimeout yields to event loop multiple times, letting browser settle before loading scripts
+  const loaderScript = `
+<script>
+(function() {
+  var scripts = ${JSON.stringify(preloads)};
+  function loadScripts() {
+    scripts.forEach(function(src) {
+      var script = document.createElement('script');
+      script.type = 'module';
+      script.src = src;
+      document.head.appendChild(script);
+    });
+  }
+  function waitIdle(n) {
+    if (n <= 0) {
+      requestAnimationFrame(function() {
+        requestAnimationFrame(loadScripts);
+      });
+      return;
+    }
+    setTimeout(function() {
+      setTimeout(function() {
+        waitIdle(n - 1);
+      }, 0);
+    }, 0);
+  }
+  waitIdle(5);
+})();
+</script>`
+
+  // Insert the loader script before </head>
+  html = html.replace('</head>', `${loaderScript}</head>`)
+
+  return html
+}

package/src/constants.ts

@@ -28,4 +28,5 @@ export const getSpaHeaderElements = ({
   <script>globalThis['global'] = globalThis</script>
   <script>globalThis['__vxrnIsSPA'] = true</script>
   <script>globalThis["${SERVER_CONTEXT_KEY}"] = ${JSON.stringify(serverContext)}</script>
+  <script>globalThis.__oneLoadedCSS = new Set(${JSON.stringify(serverContext.css || [])})</script>
 `

package/src/createApp.tsx

@@ -73,6 +73,7 @@ export function createApp(options: CreateAppProps) {
 
         let html = await renderToString(rootElement, {
           preloads: props.preloads,
+          deferredPreloads: props.deferredPreloads,
         })
 
         try {

package/src/router/filterRootHTML.ts

@@ -1,4 +1,4 @@
-import { cloneElement, isValidElement } from 'react'
+import { isValidElement } from 'react'
 
 type Props = Record<string, any>
 
@@ -36,12 +36,8 @@ export function filterRootHTML(el: React.ReactNode): FoundRootHTML {
     const { type, props } = reactElement
 
     if (type === 'html') {
-      if (
-        reactElement.props &&
-        typeof reactElement.props === 'object' &&
-        'children' in reactElement.props
-      ) {
-        const { children, ...restProps } = reactElement.props
+      if (props && typeof props === 'object' && 'children' in props) {
+        const { children, ...restProps } = props
         htmlProps = restProps
         return traverse(children as React.ReactNode)
       }
@@ -54,13 +50,13 @@ export function filterRootHTML(el: React.ReactNode): FoundRootHTML {
     }
 
     if (type === 'body') {
-      if (
-        reactElement.props &&
-        typeof reactElement.props === 'object' &&
-        'children' in reactElement.props
-      ) {
-        const { children, ...restProps } = reactElement.props
+      if (props && typeof props === 'object' && 'children' in props) {
+        const { children, ...restProps } = props
         bodyProps = restProps
+        if (process.env.TAMAGUI_TARGET === 'native') {
+          // must traverse children so nested HTML elements (e.g. <div>) get filtered on native
+          return traverse(children as React.ReactNode)
+        }
         return children as React.ReactNode
       }
       return null
@@ -72,8 +68,11 @@ export function filterRootHTML(el: React.ReactNode): FoundRootHTML {
         typeof element.type === 'string' &&
         element.type.toLowerCase() === element.type
       ) {
-        // filter out things like <meta /> etc on native
-        // because it could just be thown in <html> or a fragment to be hoisted on web
+        // filter out HTML elements on native (e.g. <div>, <meta>)
+        // preserve children so <div><Slot/></div> renders <Slot/> instead of nothing
+        if (element.props && typeof element.props === 'object' && 'children' in element.props) {
+          return traverse(element.props.children as React.ReactNode)
+        }
         return null
       }
     }

package/src/server/ServerContextScript.tsx

@@ -19,6 +19,11 @@ export function ServerContextScript() {
 
   if (process.env.VITE_ENVIRONMENT === 'ssr') {
     const context = useServerContext()
+    const cssUrls = context?.css || []
+
+    // Exclude cssContents from client context - CSS is already inlined in <style> tags
+    // Including it would duplicate 100KB+ of CSS as JSON, blocking the main thread
+    const { cssContents: _, ...clientContext } = context || {}
 
     return (
       <script
@@ -29,9 +34,10 @@ export function ServerContextScript() {
         dangerouslySetInnerHTML={{
           __html: `
               globalThis["${SERVER_CONTEXT_KEY}"] = ${JSON.stringify({
-                ...context,
+                ...clientContext,
                 postRenderData: SERVER_CONTEXT_POST_RENDER_STRING,
               })};
+              globalThis.__oneLoadedCSS = new Set(${JSON.stringify(cssUrls)});
           `,
         }}
       />

package/src/server/oneServe.ts

@@ -111,7 +111,6 @@ export async function oneServe(oneOptions: One.PluginOptions, buildInfo: One.Bui
         try {
           const exported = await import(toAbsolute(buildInfo.serverJsPath))
           const loaderData = await exported.loader?.(loaderProps)
-          const preloads = buildInfo.preloads
 
           const headers = new Headers()
           headers.set('content-type', 'text/html')
@@ -121,7 +120,9 @@ export async function oneServe(oneOptions: One.PluginOptions, buildInfo: One.Bui
             loaderData,
             loaderProps,
             path: loaderProps?.path || '/',
-            preloads,
+            // Use separated preloads for optimal loading
+            preloads: buildInfo.criticalPreloads || buildInfo.preloads,
+            deferredPreloads: buildInfo.deferredPreloads,
             css: buildInfo.css,
             cssContents: buildInfo.cssContents,
           })

package/src/server-render.tsx

@@ -1,11 +1,38 @@
 import ReactDOMServer from 'react-dom/server.browser'
 
-export const renderToString = async (app: React.ReactElement, options: { preloads?: string[] }) => {
+export type RenderToStringOptions = {
+  /**
+   * Critical scripts that need to execute immediately (will use async).
+   * These are added to bootstrapModules and generate both modulepreload links and async script tags.
+   * Keep this list minimal (typically: setupClient, one-entry, page entry).
+   */
+  preloads?: string[]
+
+  /**
+   * Non-critical scripts that can wait (will only be modulepreload hints).
+   * These only generate <link rel="modulepreload"> tags and are loaded when imported.
+   * Use this for component libraries, utilities, and other non-essential modules.
+   */
+  deferredPreloads?: string[]
+}
+
+export const renderToString = async (app: React.ReactElement, options: RenderToStringOptions) => {
   const readableStream = await ReactDOMServer.renderToReadableStream(app, {
+    // Only pass critical scripts to bootstrapModules
+    // These generate both modulepreload links AND async script tags
     bootstrapModules: options.preloads,
   })
   await readableStream.allReady
-  const out = await streamToString(readableStream)
+  let out = await streamToString(readableStream)
+
+  // Add non-critical modulepreload links to head (just hints, no script execution)
+  if (options.deferredPreloads?.length) {
+    const modulepreloadLinks = options.deferredPreloads
+      .map((src) => `<link rel="modulepreload" fetchPriority="low" href="${src}"/>`)
+      .join('')
+    out = out.replace('</head>', `${modulepreloadLinks}</head>`)
+  }
+
   return out
 }
 

package/src/types.ts

@@ -19,7 +19,16 @@ export type LoaderProps<Params extends Object = Record<string, string | string[]
 export type RenderAppProps = {
   mode: One.RouteRenderMode
   path: string
+  /**
+   * Critical scripts that need to execute immediately (will use async).
+   * These generate both modulepreload links and async script tags.
+   */
   preloads?: string[]
+  /**
+   * Non-critical scripts that can wait (will only be modulepreload hints).
+   * These only generate <link rel="modulepreload"> tags and load when imported.
+   */
+  deferredPreloads?: string[]
   css?: string[]
   /** When inlineLayoutCSS is enabled, this contains the actual CSS content to inline */
   cssContents?: string[]

package/src/vite/one.ts

@@ -204,9 +204,15 @@ export function one(options: One.PluginOptions = {}): PluginOption {
             return
           }
 
-          tsConfigPathsPlugin = tsconfigPaths(
-            pathsConfig && typeof pathsConfig === 'object' ? pathsConfig : {}
-          )
+          const skipDotDirs = (dir: string) => {
+            const name = dir.split('/').pop() || ''
+            return name.startsWith('.')
+          }
+
+          tsConfigPathsPlugin = tsconfigPaths({
+            skip: skipDotDirs,
+            ...(pathsConfig && typeof pathsConfig === 'object' ? pathsConfig : {}),
+          })
         },
 
         configResolved() {},

package/src/vite/types.ts

@@ -344,6 +344,26 @@ export namespace One {
        */
       inlineLayoutCSS?: boolean
 
+      /**
+       * @experimental
+       * Controls how scripts are loaded for improved performance.
+       *
+       * - `'defer-non-critical'`: Critical scripts (framework entry, page, layouts) load immediately.
+       *   Non-critical scripts (component imports, utilities) become modulepreload hints only,
+       *   reducing network/CPU contention.
+       *
+       * - `'after-lcp'`: Scripts download immediately via modulepreload but execution is deferred
+       *   until after first paint using double requestAnimationFrame. This allows the browser to
+       *   paint the SSR content before executing JavaScript. Only applies to SSG pages.
+       *
+       * - `'after-lcp-aggressive'`: Only modulepreloads critical scripts (entry, layouts).
+       *   Non-critical scripts have no modulepreload hints, reducing network saturation.
+       *   Best for pages with many chunks or slow networks.
+       *
+       * @default undefined (all scripts load with async)
+       */
+      experimental_scriptLoading?: 'defer-non-critical' | 'after-lcp' | 'after-lcp-aggressive'
+
       /**
        * Generate a sitemap.xml file during build.
        *
@@ -445,7 +465,12 @@ export namespace One {
     serverJsPath: string
     params: Object
     loaderData: any
+    /** All preloads (for backwards compatibility) */
     preloads: string[]
+    /** Critical preloads that load immediately with async */
+    criticalPreloads?: string[]
+    /** Non-critical preloads that are modulepreload hints only */
+    deferredPreloads?: string[]
     css: string[]
     /** When inlineLayoutCSS is enabled, contains the actual CSS content */
     cssContents?: string[]

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAoCA,wBAAsB,KAAK,CAAC,IAAI,EAAE;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAA;CACrC,iBAqmBA"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAoCA,wBAAsB,KAAK,CAAC,IAAI,EAAE;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAA;CACrC,iBAqpBA"}

package/types/cli/buildPage.d.ts

@@ -1,3 +1,3 @@
 import type { One, RouteInfo } from '../vite/types';
-export declare function buildPage(serverEntry: string, path: string, relativeId: string, params: any, foundRoute: RouteInfo<string>, clientManifestEntry: any, staticDir: string, clientDir: string, builtMiddlewares: Record<string, string>, serverJsPath: string, preloads: string[], allCSS: string[], routePreloads: Record<string, string>, allCSSContents?: string[]): Promise<One.RouteBuildInfo>;
+export declare function buildPage(serverEntry: string, path: string, relativeId: string, params: any, foundRoute: RouteInfo<string>, clientManifestEntry: any, staticDir: string, clientDir: string, builtMiddlewares: Record<string, string>, serverJsPath: string, preloads: string[], allCSS: string[], routePreloads: Record<string, string>, allCSSContents?: string[], criticalPreloads?: string[], deferredPreloads?: string[], useAfterLCP?: boolean, useAfterLCPAggressive?: boolean): Promise<One.RouteBuildInfo>;
 //# sourceMappingURL=buildPage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"buildPage.d.ts","sourceRoot":"","sources":["../../src/cli/buildPage.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAInD,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,EAC7B,mBAAmB,EAAE,GAAG,EACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAmL7B"}
+{"version":3,"file":"buildPage.d.ts","sourceRoot":"","sources":["../../src/cli/buildPage.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAInD,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,EAC7B,mBAAmB,EAAE,GAAG,EACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,cAAc,CAAC,EAAE,MAAM,EAAE,EACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAC3B,WAAW,CAAC,EAAE,OAAO,EACrB,qBAAqB,CAAC,EAAE,OAAO,GAC9B,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CA4N7B"}

package/types/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEvC,eAAO,MAAM,WAAW,SAA2E,CAAA;AACnG,eAAO,MAAM,WAAW,SAA2E,CAAA;AACnG,eAAO,MAAM,QAAQ,SAA0C,CAAA;AAE/D,eAAO,MAAM,SAAS,QAA4E,CAAA;AAElG,eAAO,MAAM,0BAA0B,oBAAoB,CAAA;AAC3D,eAAO,MAAM,8BAA8B,0BAAwC,CAAA;AACnF,eAAO,MAAM,uBAAuB,QAA6C,CAAA;AACjF,eAAO,MAAM,iBAAiB,QAA+C,CAAA;AAE7E,eAAO,MAAM,kBAAkB,QAA6B,CAAA;AAC5D,eAAO,MAAM,sBAAsB,QAAiC,CAAA;AAGpE,eAAO,MAAM,qBAAqB,wBAAwB,CAAA;AAC1D,eAAO,MAAM,oBAAoB,oCAAyC,CAAA;AAE1E,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAE1D,eAAO,MAAM,oBAAoB,GAAI,qBAElC;IACD,aAAa,CAAC,EAAE,GAAG,CAAC,aAAa,CAAA;CAC7B,WAIL,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEvC,eAAO,MAAM,WAAW,SAA2E,CAAA;AACnG,eAAO,MAAM,WAAW,SAA2E,CAAA;AACnG,eAAO,MAAM,QAAQ,SAA0C,CAAA;AAE/D,eAAO,MAAM,SAAS,QAA4E,CAAA;AAElG,eAAO,MAAM,0BAA0B,oBAAoB,CAAA;AAC3D,eAAO,MAAM,8BAA8B,0BAAwC,CAAA;AACnF,eAAO,MAAM,uBAAuB,QAA6C,CAAA;AACjF,eAAO,MAAM,iBAAiB,QAA+C,CAAA;AAE7E,eAAO,MAAM,kBAAkB,QAA6B,CAAA;AAC5D,eAAO,MAAM,sBAAsB,QAAiC,CAAA;AAGpE,eAAO,MAAM,qBAAqB,wBAAwB,CAAA;AAC1D,eAAO,MAAM,oBAAoB,oCAAyC,CAAA;AAE1E,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAE1D,eAAO,MAAM,oBAAoB,GAAI,qBAElC;IACD,aAAa,CAAC,EAAE,GAAG,CAAC,aAAa,CAAA;CAC7B,WAKL,CAAA"}

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;AAK7C,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;EAwIzC"}
+{"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;AAK7C,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;EAyIzC"}

package/types/router/filterRootHTML.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filterRootHTML.d.ts","sourceRoot":"","sources":["../../src/router/filterRootHTML.ts"],"names":[],"mappings":"AAEA,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAEhC,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAA;IAC5B,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,YAAY,CAAA;CAC1B,CAAA;AAED;;;;;;;;GAQG;AAEH,wBAAgB,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,SAAS,GAAG,aAAa,CAyEjE"}
+{"version":3,"file":"filterRootHTML.d.ts","sourceRoot":"","sources":["../../src/router/filterRootHTML.ts"],"names":[],"mappings":"AAEA,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAEhC,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAA;IAC5B,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,YAAY,CAAA;CAC1B,CAAA;AAED;;;;;;;;GAQG;AAEH,wBAAgB,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,SAAS,GAAG,aAAa,CAwEjE"}

package/types/server/ServerContextScript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServerContextScript.d.ts","sourceRoot":"","sources":["../../src/server/ServerContextScript.tsx"],"names":[],"mappings":"AAIA,wBAAgB,mBAAmB,mDAqClC"}
+{"version":3,"file":"ServerContextScript.d.ts","sourceRoot":"","sources":["../../src/server/ServerContextScript.tsx"],"names":[],"mappings":"AAIA,wBAAgB,mBAAmB,mDA2ClC"}

package/types/server/oneServe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oneServe.d.ts","sourceRoot":"","sources":["../../src/server/oneServe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAqB,MAAM,MAAM,CAAA;AAoBnD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AAKxC,wBAAsB,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,iBA+ThG"}
+{"version":3,"file":"oneServe.d.ts","sourceRoot":"","sources":["../../src/server/oneServe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAqB,MAAM,MAAM,CAAA;AAoBnD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AAKxC,wBAAsB,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,iBAgUhG"}

package/types/server-render.d.ts

@@ -1,4 +1,16 @@
-export declare const renderToString: (app: React.ReactElement, options: {
+export type RenderToStringOptions = {
+    /**
+     * Critical scripts that need to execute immediately (will use async).
+     * These are added to bootstrapModules and generate both modulepreload links and async script tags.
+     * Keep this list minimal (typically: setupClient, one-entry, page entry).
+     */
     preloads?: string[];
-}) => Promise<string>;
+    /**
+     * Non-critical scripts that can wait (will only be modulepreload hints).
+     * These only generate <link rel="modulepreload"> tags and are loaded when imported.
+     * Use this for component libraries, utilities, and other non-essential modules.
+     */
+    deferredPreloads?: string[];
+};
+export declare const renderToString: (app: React.ReactElement, options: RenderToStringOptions) => Promise<string>;
 //# sourceMappingURL=server-render.d.ts.map

package/types/server-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-render.d.ts","sourceRoot":"","sources":["../src/server-render.tsx"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,GAAU,KAAK,KAAK,CAAC,YAAY,EAAE,SAAS;IAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,oBAO7F,CAAA"}
+{"version":3,"file":"server-render.d.ts","sourceRoot":"","sources":["../src/server-render.tsx"],"names":[],"mappings":"AAEA,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IAEnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC5B,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,KAAK,KAAK,CAAC,YAAY,EAAE,SAAS,qBAAqB,oBAkB3F,CAAA"}

package/types/types.d.ts

@@ -13,7 +13,16 @@ export type LoaderProps<Params extends Object = Record<string, string | string[]
 export type RenderAppProps = {
     mode: One.RouteRenderMode;
     path: string;
+    /**
+     * Critical scripts that need to execute immediately (will use async).
+     * These generate both modulepreload links and async script tags.
+     */
     preloads?: string[];
+    /**
+     * Non-critical scripts that can wait (will only be modulepreload hints).
+     * These only generate <link rel="modulepreload"> tags and load when imported.
+     */
+    deferredPreloads?: string[];
     css?: string[];
     /** When inlineLayoutCSS is enabled, this contains the actual CSS content to inline */
     cssContents?: string[];

package/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEvC,yFAAyF;AACzF,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,CAAA;AAEhF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;AAExE,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;AAE1E,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAElE,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI;IACnF,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,GAAG,CAAC,eAAe,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,gBAAgB,CAAC,EAAE,GAAG,CAAA;IACtB,UAAU,CAAC,EAAE,GAAG,CAAA;IAChB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEvC,yFAAyF;AACzF,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,CAAA;AAEhF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;AAExE,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;AAE1E,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAElE,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI;IACnF,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,GAAG,CAAC,eAAe,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,gBAAgB,CAAC,EAAE,GAAG,CAAA;IACtB,UAAU,CAAC,EAAE,GAAG,CAAA;IAChB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC,CAAA"}

package/types/vite/one.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"one.d.ts","sourceRoot":"","sources":["../../src/vite/one.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,MAAM,CAAA;AAOhD,OAAO,qBAAqB,CAAA;AAW5B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAoBlC,wBAAgB,GAAG,CAAC,OAAO,GAAE,GAAG,CAAC,aAAkB,GAAG,YAAY,CA8jBjE"}
+{"version":3,"file":"one.d.ts","sourceRoot":"","sources":["../../src/vite/one.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,MAAM,CAAA;AAOhD,OAAO,qBAAqB,CAAA;AAW5B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAoBlC,wBAAgB,GAAG,CAAC,OAAO,GAAE,GAAG,CAAC,aAAkB,GAAG,YAAY,CAokBjE"}