one 1.2.38 → 1.2.39-1766066124062

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,38 @@ 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
+
+    // When 'defer-non-critical' is enabled, separate critical from non-critical
+    const useDeferredLoading = scriptLoadingMode === 'defer-non-critical'
+
+    // Critical: scripts that must execute immediately (async)
+    const criticalPreloads = useDeferredLoading
+      ? [
+          ...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 = useDeferredLoading
+      ? [...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 = useDeferredLoading ? [...criticalPreloads!, ...deferredPreloads!] : allPreloads
 
     const allEntries = [clientManifestEntry, ...layoutEntries]
     const allCSS = allEntries
@@ -471,9 +501,13 @@ 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 useAfterLCP = foundRoute.type === 'ssg' && scriptLoadingMode === 'after-lcp'
+
     for (const params of paramsList) {
       const path = getPathnameFromFilePath(relativeId, params, foundRoute.type === 'ssg')
-      console.info(`  ↦ route ${path}`)
+      console.info(`  ↦ route ${path}${useAfterLCP ? ' (after-lcp)' : ''}`)
 
       const built = await runWithAsyncLocalContext(async () => {
         return await buildPage(
@@ -490,7 +524,10 @@ export async function build(args: {
           preloads,
           allCSS,
           routePreloads,
-          allCSSContents
+          allCSSContents,
+          criticalPreloads,
+          deferredPreloads,
+          useAfterLCP
         )
       })
 

package/src/cli/buildPage.ts

@@ -23,7 +23,10 @@ export async function buildPage(
   preloads: string[],
   allCSS: string[],
   routePreloads: Record<string, string>,
-  allCSSContents?: string[]
+  allCSSContents?: string[],
+  criticalPreloads?: string[],
+  deferredPreloads?: string[],
+  useAfterLCP?: boolean
 ): Promise<One.RouteBuildInfo> {
   const render = await getRender(serverEntry)
   const htmlPath = `${path.endsWith('/') ? `${removeTrailingSlash(path)}/index` : path}.html`
@@ -65,13 +68,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 +93,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 +153,11 @@ if (typeof document === 'undefined') globalThis.document = {}
       globalThis['__vxrnresetState']?.()
 
       if (foundRoute.type === 'ssg') {
-        const html = await render({
+        let html = await render({
           path,
-          preloads,
+          // Use separated preloads if available, otherwise fall back to all preloads
+          preloads: criticalPreloads || preloads,
+          deferredPreloads: deferredPreloads,
           loaderProps,
           loaderData,
           css: allCSS,
@@ -144,6 +165,12 @@ if (typeof document === 'undefined') globalThis.document = {}
           mode: 'ssg',
           routePreloads,
         })
+
+        // Apply after-LCP script loading if enabled
+        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 +181,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}" async=""></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 +238,8 @@ params:\n\n${JSON.stringify(params || null, null, 2)}`
     params,
     path,
     preloads,
+    criticalPreloads,
+    deferredPreloads,
   }
 }
 
@@ -234,3 +272,41 @@ 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 scripts download immediately in parallel.
+ * Removes async script tags and adds a double-rAF loader that executes
+ * scripts after at least one paint has happened.
+ */
+function applyAfterLCPScriptLoad(html: string, preloads: string[]): string {
+  // Remove all <script type="module" ... async> tags (prevents immediate execution)
+  // Keep modulepreload links so scripts download in parallel immediately
+  html = html.replace(/<script\s+type="module"[^>]*async[^>]*><\/script>/gi, '')
+
+  // Create the double-rAF loader script
+  // Downloads happen immediately via modulepreload, execution waits for paint
+  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);
+    });
+  }
+  // Double rAF ensures at least one paint has happened before executing JS
+  requestAnimationFrame(function() {
+    requestAnimationFrame(loadScripts);
+  });
+})();
+</script>`
+
+  // Insert the loader script before </head>
+  html = html.replace('</head>', `${loaderScript}</head>`)
+
+  return html
+}

package/src/cli/generateSitemap.test.ts

@@ -1,8 +1,23 @@
-import { describe, expect, it } from 'vitest'
+import { describe, expect, it, beforeEach, afterEach } from 'vitest'
 import { generateSitemap, type RouteSitemapData } from './generateSitemap'
 import type { One } from '../vite/types'
 
 describe('generateSitemap', () => {
+  let originalEnv: string | undefined
+
+  beforeEach(() => {
+    originalEnv = process.env.ONE_SERVER_URL
+    delete process.env.ONE_SERVER_URL
+  })
+
+  afterEach(() => {
+    if (originalEnv !== undefined) {
+      process.env.ONE_SERVER_URL = originalEnv
+    } else {
+      delete process.env.ONE_SERVER_URL
+    }
+  })
+
   it('generates basic sitemap XML', () => {
     const routes: RouteSitemapData[] = [{ path: '/' }, { path: '/about' }, { path: '/blog' }]
     const options: One.SitemapOptions = {}
@@ -42,19 +57,14 @@ describe('generateSitemap', () => {
   })
 
   it('uses ONE_SERVER_URL env var when baseUrl not provided', () => {
-    const originalEnv = process.env.ONE_SERVER_URL
     process.env.ONE_SERVER_URL = 'https://env-url.com'
 
-    try {
-      const routes: RouteSitemapData[] = [{ path: '/test' }]
-      const options: One.SitemapOptions = {}
+    const routes: RouteSitemapData[] = [{ path: '/test' }]
+    const options: One.SitemapOptions = {}
 
-      const result = generateSitemap(routes, options)
+    const result = generateSitemap(routes, options)
 
-      expect(result).toContain('<loc>https://env-url.com/test</loc>')
-    } finally {
-      process.env.ONE_SERVER_URL = originalEnv
-    }
+    expect(result).toContain('<loc>https://env-url.com/test</loc>')
   })
 
   it('applies default priority to all routes', () => {

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/server/ServerContextScript.tsx

@@ -19,6 +19,7 @@ export function ServerContextScript() {
 
   if (process.env.VITE_ENVIRONMENT === 'ssr') {
     const context = useServerContext()
+    const cssUrls = context?.css || []
 
     return (
       <script
@@ -32,6 +33,7 @@ export function ServerContextScript() {
                 ...context,
                 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/ui/common.tsx

@@ -7,6 +7,7 @@ import { resolveHref } from '../link/href'
 import { sortRoutesWithInitial } from '../router/sortRoutes'
 import type { OneRouter } from '../interfaces/router'
 import { Slot } from './Slot'
+import { Screen, createGetIdForRoute, getQualifiedRouteComponent } from '../router/useScreens'
 
 export const ViewSlot = Slot
 
@@ -190,10 +191,6 @@ export function triggersToScreens(
   const children: React.JSX.Element[] = []
   const triggerMap: TriggerMap = { ...parentTriggerMap }
 
-  // Import routeToScreen from One's useScreens
-  const { Screen } = require('../router/useScreens')
-  const { createGetIdForRoute } = require('../router/useScreens')
-
   for (const [index, config] of sortedConfigs.entries()) {
     triggerMap[config.name] = { ...config, index }
 
@@ -219,10 +216,7 @@ export function triggersToScreens(
 
             return output
           }}
-          getComponent={() => {
-            const { getQualifiedRouteComponent } = require('../router/useScreens')
-            return getQualifiedRouteComponent(route)
-          }}
+          getComponent={() => getQualifiedRouteComponent(route)}
         />
       )
     }

package/src/vite/types.ts

@@ -344,6 +344,22 @@ 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.
+       *
+       * @default undefined (all scripts load with async)
+       */
+      experimental_scriptLoading?: 'defer-non-critical' | 'after-lcp'
+
       /**
        * Generate a sitemap.xml file during build.
        *
@@ -445,7 +461,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,iBA0oBA"}

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): 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,GACpB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAsN7B"}

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/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,mDAuClC"}

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/ui/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/ui/common.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAElG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B,eAAO,MAAM,QAAQ,8GAAO,CAAA;AAE5B,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,SAAS,CAAC,IAAI,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;CACb,GACD;IACE,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAEL,KAAK,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAA;AAC7E,KAAK,aAAa,GACd;IACE,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,sBAAsB,CAAA;CAC/B,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AA+B1E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EAAE,EACzB,eAAe,EAAE,SAAS,EAC1B,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,EACtC,gBAAgB,EAAE,SAAS,GAAG,MAAM,EACpC,gBAAgB,EAAE,UAAU,EAC5B,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM;;;EAgKnB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,EAClE,YAAY,CAAC,EAAE,MAAM,GACpB,sBAAsB,CAsCxB"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/ui/common.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAElG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,eAAO,MAAM,QAAQ,8GAAO,CAAA;AAE5B,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,SAAS,CAAC,IAAI,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;CACb,GACD;IACE,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAEL,KAAK,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAA;AAC7E,KAAK,aAAa,GACd;IACE,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,sBAAsB,CAAA;CAC/B,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AA+B1E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EAAE,EACzB,eAAe,EAAE,SAAS,EAC1B,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,EACtC,gBAAgB,EAAE,SAAS,GAAG,MAAM,EACpC,gBAAgB,EAAE,UAAU,EAC5B,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM;;;EAyJnB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,EAClE,YAAY,CAAC,EAAE,MAAM,GACpB,sBAAsB,CAsCxB"}

package/types/vite/types.d.ts

@@ -300,6 +300,21 @@ export declare namespace One {
              * @default false
              */
             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.
+             *
+             * @default undefined (all scripts load with async)
+             */
+            experimental_scriptLoading?: 'defer-non-critical' | 'after-lcp';
             /**
              * Generate a sitemap.xml file during build.
              *
@@ -390,7 +405,12 @@ export declare 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[];