@thomas.f/prnext 0.1.15-alpha → 0.1.17-alpha

package/runtime/dev-ai-style.mjs

@@ -0,0 +1,99 @@
+// Development-only inspector surfaces. No styles escape the tools' shadow root.
+export const devAiStyle = `
+  dialog.wb-tools[data-panel=ai]{width:min(420px,calc(100vw - 32px));height:fit-content;max-height:calc(100dvh - 48px)}
+  dialog.wb-tools[data-panel=ai][data-selection=true]{width:min(560px,calc(100vw - 32px))}
+  [data-panel=ai] .wb-tools-content{padding:48px 20px 20px;flex:0 1 auto;max-height:calc(100dvh - 48px);overscroll-behavior:contain}
+  [data-panel=ai] .wb-head{display:contents}
+  [data-panel=ai] .wb-head>:not(.wb-close),[data-panel=ai] .wb-tools-nav,[data-panel=ai] .wb-tools-search,[data-panel=ai] .wb-ai-hero{display:none}
+  [data-panel=ai] .wb-close{position:absolute;top:8px;right:8px;z-index:2;width:34px;min-height:34px;background:#080808;color:#999}
+  [data-panel=ai] .wb-close:hover{color:#fff;background:#191919}
+  [data-panel=ai] .wb-tools-feedback{padding:0 20px 16px;font-size:11px;overflow-wrap:anywhere}
+  [data-panel=ai] [hidden]{display:none!important}
+  .wb-ai-layout{display:block;width:100%;margin:0 auto;min-width:0}
+  .wb-ai-layout>*{min-width:0}.wb-ai-has-selection{max-width:none}
+  .wb-ai-connect{min-width:0}
+  .wb-ai-connect>.wb-host-error{margin:8px 0 0;font-size:11px;line-height:1.5;overflow-wrap:anywhere}
+  .wb-ai-hero{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:center;gap:5px 10px;margin-bottom:16px}
+  .wb-ai-heading{margin:0;font-size:14px;font-weight:550;letter-spacing:-.02em;line-height:1.4}
+  .wb-ai-description{grid-column:1/-1;color:#999;font-size:11px;line-height:1.6;margin:0}
+  .wb-ai-status{display:inline-flex;align-items:center;gap:6px;grid-column:2;grid-row:1;font-size:10px;white-space:nowrap;color:#999}
+  .wb-ai-status i{width:5px;height:5px;border-radius:50%;background:#777;flex:none}
+  .wb-ai-status[data-connected=true]{color:#a8dabd}.wb-ai-status[data-connected=true] i{background:#87d5a8}
+  .wb-ai-layout[data-connected=true] .wb-ai-hero{margin-bottom:0}
+  .wb-ai-setup{margin:0;min-width:0}
+  .wb-ai-layout[data-connected=true] .wb-ai-setup{margin-top:0}
+  .wb-ai-setup>summary{display:flex;align-items:center;gap:8px;min-height:32px;list-style:none;color:#8e8e8e;font-size:10px;cursor:pointer;user-select:none}
+  .wb-ai-setup>summary::-webkit-details-marker{display:none}
+  .wb-ai-setup>summary::after{content:'';width:5px;height:5px;margin-left:auto;border-right:1px solid currentColor;border-bottom:1px solid currentColor;rotate:45deg;translate:0 -2px}
+  .wb-ai-setup[open]>summary::after{rotate:225deg;translate:0 1px}
+  .wb-ai-setup>summary:hover{color:#ddd}
+  .wb-ai-setup-content{min-width:0}
+  .wb-ai-layout[data-connected=true] .wb-ai-setup-content{padding-top:0}
+  .wb-ai-workspace{min-width:0;margin:0;padding:0;border:0}
+  .wb-ai-ready{display:flex;flex-direction:column;align-items:center;gap:10px;padding:12px 0 8px;text-align:center}
+  .wb-ai-ready p{max-width:340px;margin:0;color:#888;font-size:11px;line-height:1.6;text-wrap:pretty}
+  .wb .wb-ai-select{display:inline-flex;align-items:center;justify-content:center;gap:8px;min-height:36px;padding:8px 13px;border-radius:8px;background:#ededed;color:#0c0c0c;font-size:11px;font-weight:550}
+  .wb .wb-ai-select:hover:not(:disabled){background:#d6d6d6;color:#080808}.wb-ai-select svg{width:15px;height:15px}
+  .wb-host-connect{padding:0;background:transparent}
+  .wb-host-heading{display:flex;align-items:center;gap:7px;min-width:0;font-size:11px}.wb-host-heading svg{width:14px;height:14px;color:#999}
+  .wb-host-heading strong{font-weight:500}.wb-host-state{display:none}
+  .wb-host-command{display:flex;align-items:center;gap:8px;margin-top:8px;min-width:0;background:#111;border-radius:8px;padding:3px 3px 3px 10px}
+  .wb-host-command code{min-width:0;flex:1;white-space:pre-wrap;overflow-wrap:anywhere;font:11px/1.7 ui-monospace,SFMono-Regular,Consolas,monospace;color:#ddd}
+  .wb .wb-host-copy{display:grid;place-items:center;flex:none;width:34px;padding:6px;color:#999}.wb-host-copy svg{width:14px;height:14px}
+  .wb-host-note{color:#888;font-size:10px;line-height:1.6;margin:6px 0 0}
+  .wb-ai-divider{margin:16px 0 8px;color:#888;font-size:10px}
+  .wb-ai-clients{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:2px;padding:3px;border-radius:10px;background:#111}
+  .wb .wb-ai-client{display:flex;align-items:center;justify-content:center;gap:7px;min-width:0;min-height:40px;padding:8px 6px;border:0;border-radius:7px;background:transparent;color:#aaa}
+  .wb .wb-ai-client:hover:not(:disabled){background:#1b1b1b;color:#fff}
+  .wb .wb-ai-client[aria-pressed=true]{background:#262626;color:#fff}
+  .wb-ai-client-logo{display:grid;place-items:center;width:20px;height:20px}.wb-ai-client-logo svg{width:20px;height:20px}
+  .wb-ai-client-label{font-size:11px;font-weight:500}.wb-ai-client-check{display:none}
+  .wb-ai-client:disabled{opacity:.5;cursor:default}
+  .wb .wb-ai-other{display:flex;align-items:center;justify-content:center;gap:6px;margin:4px 0 0 auto;min-height:28px;padding:4px 7px;color:#888;font-size:10px}
+  .wb-ai-other svg{width:13px;height:13px}.wb-ai-other[aria-pressed=true]{color:#eee;background:#191919}
+  .wb-local-setup{margin-top:8px;padding:0}
+  .wb-local-setup summary{display:flex;align-items:center;gap:8px;list-style:none;min-height:28px;color:#aaa;font-size:11px;cursor:pointer}
+  .wb-local-setup summary::-webkit-details-marker{display:none}.wb-local-setup summary::after{content:'';width:5px;height:5px;margin-left:auto;border-right:1px solid currentColor;border-bottom:1px solid currentColor;rotate:45deg;translate:0 -2px}
+  .wb-local-setup[open] summary::after{rotate:225deg;translate:0 1px}
+  .wb-mcp-reveal,.wb-mcp-help-reveal{height:0;min-width:0;overflow:hidden;opacity:0}
+  .wb-mcp-reveal[data-expanded=true],.wb-mcp-help-reveal[data-expanded=true]{opacity:1}
+  .wb-mcp-content{min-width:0;padding-top:8px;opacity:1}.wb-mcp-content[data-swapping=true]{opacity:.35}
+  .wb-local-setup .wb-mcp-controls{justify-content:space-between;align-items:center;flex-wrap:nowrap;gap:8px;margin:0;min-width:0}.wb-mcp-format{font-size:10px;color:#999}
+  .wb .wb-mcp-help-toggle{display:grid;place-items:center;flex:none;width:28px;min-height:28px;padding:0;border-radius:7px;color:#999;background:transparent;font-size:11px}
+  .wb .wb-mcp-help-toggle:hover,.wb .wb-mcp-help-toggle[aria-expanded=true]{background:#191919;color:#ddd}.wb-mcp-help-toggle svg{width:14px;height:14px}
+  .wb-mcp-help{padding:7px 0 1px;color:#999;font-size:10px;line-height:1.6;overflow-wrap:anywhere}.wb-mcp-help p{margin:0}.wb-mcp-help a{display:inline-flex;align-items:center;gap:4px;min-height:28px;color:#c3b9f1;text-decoration:none;text-underline-offset:3px}.wb-mcp-help a:hover{text-decoration:underline}
+  .wb-mcp-snippet{display:grid;grid-template-columns:minmax(0,1fr) 34px;align-items:center;gap:6px;min-width:0;margin-top:8px}
+  .wb .wb-config-copy{display:grid;place-items:center;align-self:center;width:34px;height:34px;min-height:34px;padding:0;border-radius:8px;color:#999;background:transparent}.wb .wb-config-copy:hover{color:#eee;background:#191919}.wb-config-copy svg{width:14px;height:14px}
+  .wb-local-setup pre.wb-mcp-code{width:100%;height:83px;min-height:83px;max-height:83px;margin:0;padding:10px;overflow:auto;overscroll-behavior:contain;white-space:pre-wrap;overflow-wrap:anywhere;tab-size:2;font:10px/18px ui-monospace,SFMono-Regular,Consolas,monospace;color:#bcbcbc;background:#101010;border-radius:8px;scrollbar-width:thin;scrollbar-color:#333 #101010}
+  .wb-component-head{display:flex;align-items:center;justify-content:space-between;gap:8px;margin-bottom:15px}.wb-component-identity{display:flex;align-items:center;gap:10px;min-width:0}.wb-component-identity>div{min-width:0}
+  .wb-component-mark{display:grid;place-items:center;width:36px;height:36px;border-radius:11px;background:#b7c3ff12;color:#c4ccff;flex:none}.wb-component-mark svg{width:20px;height:20px}
+  .wb-component h3{margin:0 0 3px;font-size:14px;letter-spacing:-.02em;font-weight:550;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+  .wb-component-kind{display:block;font:10px/1.5 ui-monospace,SFMono-Regular,Consolas,monospace;color:#929292;font-variant-numeric:tabular-nums}
+  .wb .wb-component-reselect{display:flex;align-items:center;gap:6px;flex:none;padding:6px 8px;color:#999;font-size:10px}.wb-component-reselect svg{width:14px;height:14px}
+  .wb-component-visual{display:grid;place-items:center;position:relative;min-height:135px;max-height:190px;overflow:auto;isolation:isolate;border-radius:12px;background:#101010;box-shadow:inset 0 0 0 1px #ffffff08;padding:20px}
+  .wb-component-visual .wb-selection-image{display:block;max-width:100%;max-height:150px;object-fit:contain;object-position:center;margin:0;border-radius:4px}
+  .wb-component-visual [hidden]{display:none!important}.wb-component-placeholder{font-size:11px;color:#888;text-align:center;overflow-wrap:anywhere}
+  .wb-component-visual[data-state=error]{place-items:start;background:#e14a580b;color:#ffa2ac;min-height:90px}.wb-component-visual[data-state=error] .wb-component-placeholder{color:#ffa2ac;text-align:left;font:11px/1.65 ui-monospace,monospace}
+  .wb-component-source{display:flex;align-items:center;gap:10px;min-width:0;margin:11px 0 18px}.wb-component-location{min-width:0;flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:#909090;font:10px/1.6 ui-monospace,SFMono-Regular,Consolas,monospace}
+  .wb-component-editor{display:inline-flex;align-items:center;min-height:28px;text-decoration:none;color:#aaa;font-size:10px;white-space:nowrap}.wb-component-editor:hover{color:#eee}.wb-component-editor[hidden]{display:none}
+  .wb-component-composer{border:1px solid #303030;border-radius:12px;overflow:hidden;background:#0c0c0c}
+  .wb-component-label{display:flex;flex-direction:column;gap:9px;padding:13px 13px 0;font-size:12px;color:#ccc;font-weight:500}
+  .wb-component-label textarea{display:block;width:100%;min-height:78px;max-height:200px;resize:vertical;margin:0;padding:0 1px;border:0;border-radius:0;background:transparent;color:#eee;font:12px/1.65 ui-sans-serif,system-ui;outline-offset:3px;scrollbar-color:#333 #0c0c0c}
+  .wb-component-label textarea::placeholder{color:#666}.wb-component-label textarea:focus-visible{outline:0}
+  .wb-component-composer:focus-within{border-color:#777;box-shadow:0 0 0 1px #777}
+  .wb-component-compose-foot{display:flex;align-items:center;justify-content:space-between;gap:8px;flex-wrap:wrap;padding:10px}.wb-component-parts{font-size:9px;color:#888;overflow-wrap:anywhere}
+  .wb .wb-ai-primary{display:inline-flex;align-items:center;justify-content:center;gap:10px;min-height:34px;padding:7px 11px;border-radius:8px;background:#ededed;color:#0c0c0c;font-size:11px;font-weight:600}
+  .wb .wb-ai-primary:hover:not(:disabled){background:#d6d6d6;color:#080808}.wb-ai-primary svg{width:14px;height:14px}.wb .wb-ai-primary:disabled{opacity:.45;cursor:wait}
+  .wb-component-details{margin-top:14px}.wb-component-details summary{color:#888;font-size:10px;cursor:pointer;min-height:28px;padding:4px 0}.wb-component-details pre{max-height:180px;overflow:auto;color:#aaa;background:#111;padding:12px;border-radius:9px;margin:8px 0;scrollbar-color:#333 #111}
+  .wb-component-styles{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:5px 14px;font:10px/1.5 ui-monospace,monospace;color:#aaa;margin:12px 0}
+  .wb-component-styles dt{color:#777;min-width:0;overflow-wrap:anywhere}.wb-component-styles dd{margin:0;min-width:0;overflow-wrap:anywhere;text-align:right}
+  .wb-ai-verify{display:flex;align-items:center;justify-content:space-between;gap:14px;border-top:1px solid #202020;margin-top:16px;padding-top:12px}.wb-ai-verify strong{font-size:11px;font-weight:500;color:#bbb}.wb-ai-verify p{color:#777;font-size:10px;margin:3px 0 0}
+  .wb .wb-ai-verify-button{display:inline-flex;align-items:center;gap:7px;background:transparent;flex:none;font-size:11px;color:#bbb}.wb-ai-verify-button svg{width:13px;height:13px}
+  .wb-ai-layout button:focus-visible,.wb-ai-layout summary:focus-visible,.wb-ai-layout a:focus-visible{outline:2px solid #888;outline-offset:-3px}
+  @media(max-width:740px){.wb-component-visual{min-height:110px}}
+  @media(max-width:500px){dialog.wb-tools[data-panel=ai],dialog.wb-tools[data-panel=ai][data-selection=true]{width:calc(100vw - 16px);height:fit-content;max-height:calc(100dvh - 32px)}[data-panel=ai] .wb-tools-content{padding:48px 14px 18px;max-height:calc(100dvh - 32px)}[data-panel=ai] .wb-tools-feedback{padding:0 14px 14px}.wb-component-compose-foot{gap:10px}.wb-component-parts{width:100%}.wb .wb-ai-primary{width:100%}.wb-ai-verify{gap:10px}.wb-ai-verify p{max-width:150px}.wb-mcp-controls{align-items:flex-start}.wb-component-reselect{font-size:0!important;gap:0!important}.wb-component-reselect svg{width:17px;height:17px}.wb-component-identity{gap:8px}.wb-component-location{font-size:9px}}
+  @media(pointer:coarse){[data-panel=ai] .wb-tools-content{padding-top:60px}[data-panel=ai] .wb-close,.wb .wb-host-copy,.wb .wb-config-copy,.wb .wb-mcp-help-toggle{width:44px;min-height:44px}.wb-mcp-snippet{grid-template-columns:minmax(0,1fr) 44px}.wb-mcp-help a{min-height:44px}.wb .wb-ai-client,.wb .wb-config-copy,.wb .wb-ai-other,.wb-local-setup summary,.wb-ai-setup>summary,.wb-component-details summary,.wb-component-editor,.wb .wb-component-reselect,.wb .wb-ai-primary,.wb .wb-ai-select,.wb .wb-ai-verify-button{min-height:44px}.wb .wb-component-reselect{min-width:44px;justify-content:center}.wb-component-label textarea{font-size:16px}}
+  @media(prefers-reduced-motion:no-preference){.wb .wb-ai-client,.wb .wb-ai-select,.wb-ai-setup>summary{transition:background-color 120ms,color 120ms}.wb-component-composer{transition:border-color 120ms,box-shadow 120ms}.wb-mcp-reveal,.wb-mcp-help-reveal{transition:height 220ms ease-out,opacity 160ms ease-out}.wb-mcp-content{transition:opacity 120ms ease-out}}
+  @media(prefers-reduced-motion:reduce){.wb-mcp-reveal,.wb-mcp-help-reveal,.wb-mcp-content{transition:none!important}}
+  @media(forced-colors:active){.wb-component-visual{border:1px solid CanvasText}.wb-ai-clients{background:Canvas}.wb .wb-ai-client{border:1px solid ButtonText}.wb .wb-ai-client[aria-pressed=true]{outline:2px solid Highlight;outline-offset:-2px}.wb-component-mark{color:ButtonText}.wb .wb-ai-primary,.wb .wb-ai-select{background:ButtonFace;color:ButtonText;border:1px solid ButtonText}.wb .wb-mcp-help-toggle[aria-expanded=true]{outline:1px solid Highlight;outline-offset:-2px}.wb-mcp-help a{color:LinkText}.wb-ai-workspace,.wb-ai-verify{border-color:CanvasText}.wb-component-composer:focus-within{border-color:Highlight;outline:2px solid Highlight}.wb-ai-layout button:focus-visible,.wb-ai-layout summary:focus-visible,.wb-ai-layout a:focus-visible{outline-color:Highlight}}
+`;

package/runtime/dev-build-reasons.mjs

@@ -0,0 +1,25 @@
+const messages={
+  'initial-build':'Compile the requested routes.',
+  'route-opened':'Compile a newly opened route.',
+  'source-changed':'Source files changed.',
+  'environment-changed':'Environment variables changed; restart the compiler.',
+  'configuration-changed':'Build configuration changed; rebuild the active routes.',
+  'safe-mode':'Safe mode uses a fresh compiler and the complete route graph.',
+  'unknown-dependency':'A changed file is outside the dependency index; refresh all active routes.',
+  'dependency-capacity':'The affected graph exceeds the selective-update budget; rebuild all active routes.',
+  'missing-style-dependencies':'This build has no per-bundle style graph; rebuild styles and JavaScript together.',
+  'css-only':'Update styles without replacing the application worker.',
+  'css-module-exports':'CSS Module exports changed; rebuild JavaScript and styles together.',
+  'css-processor':'Custom CSS processing requires a complete build.',
+  'stylesheet-language':'This stylesheet requires the complete compiler.',
+  'unknown-style-dependency':'A stylesheet is outside the recorded style graph.',
+  'external-asset-base':'External asset URLs require a complete build.',
+  'outside-active-graph':'Keep this unopened route uncompiled until it is requested.',
+};
+export function devBuildReason({initial=false,safe=false,changed=[],cause}={}){
+  const code=safe?'safe-mode':initial?'initial-build':
+    changed.some(file=>/(?:^|\/)\.env(?:\.|$)/.test(file))?'environment-changed':
+    changed.some(file=>/(?:^|\/)(?:(?:prnext|next|postcss|tsconfig|jsconfig)\.config\.|(?:tsconfig|jsconfig)\.json$|package(?:-lock)?\.json$|pnpm-lock\.yaml$|yarn\.lock$)/.test(file))?'configuration-changed':
+    cause&&messages[cause]?cause:changed.length?'source-changed':'route-opened';
+  return {code,summary:messages[code]};
+}

package/runtime/dev-cache-control.mjs

@@ -0,0 +1,53 @@
+import {open,lstat,realpath,rename,rm,readFile} from 'node:fs/promises';
+import {constants} from 'node:fs';
+import {randomUUID} from 'node:crypto';
+import path from 'node:path';
+
+const name='.dev-cache-rpc.json';
+function endpoint(value){
+  let url;try{url=new URL(value);}catch{throw Error('Development cache connection is unavailable');}
+  if(url.protocol!=='http:'||url.hostname!=='127.0.0.1'||!url.port||url.pathname!=='/cache'||url.search||url.hash||url.username||url.password)throw Error('Invalid development cache endpoint');return url.href;
+}
+async function scopedDirectory(root,directory){
+  const requestedRoot=path.resolve(root),requestedDirectory=path.resolve(requestedRoot,directory);
+  root=await realpath(requestedRoot);
+  // macOS /var and Windows short-name paths can alias the project root. Map
+  // only that trusted root to its real path; links inside a generation must
+  // still be rejected rather than silently following another directory.
+  const relative=[requestedRoot,root].map(base=>path.relative(path.join(base,'.prnext-dev'),requestedDirectory)).find(value=>
+    value&&value!=='..'&&!value.startsWith('..'+path.sep)&&!path.isAbsolute(value)&&value.split(path.sep).length===2);
+  const expected=relative&&path.join(root,'.prnext-dev',relative);
+  if(!expected||await realpath(requestedDirectory)!==expected)throw Error('Development cache must belong to a live project generation');
+  return expected;
+}
+export function normalizeDevCachePath(value){
+  if(typeof value!=='string'||!value.startsWith('/')||value.startsWith('//')||value.length>1024||/[\\\u0000-\u001f]/.test(value))throw Error('A local cache pathname is required');
+  return new URL(value,'http://local').pathname.replace(/%[\da-f]{2}/gi,escape=>{const character=String.fromCharCode(parseInt(escape.slice(1),16));return /[a-z\d_.~-]/i.test(character)?character:escape.toUpperCase();}).replace(/\/+$/,'')||'/';
+}
+/** Only a development worker may publish its native process's private RPC. */
+export async function publishDevCacheCapability({root,distDir,manifest,env=process.env}){
+  if(manifest.dev!==true||typeof manifest.devSession!=='string'||typeof manifest.buildId!=='string'||!env.PRNEXT_CACHE_URL||!env.PRNEXT_CACHE_TOKEN)return false;
+  const directory=await scopedDirectory(root,distDir);
+  if(!/^[a-f\d]{64}$/i.test(env.PRNEXT_CACHE_TOKEN))throw Error('Invalid development cache capability');
+  const value={version:1,session:manifest.devSession,buildId:manifest.buildId,endpoint:endpoint(env.PRNEXT_CACHE_URL),token:env.PRNEXT_CACHE_TOKEN};
+  const filename=path.join(directory,name),temporary=filename+'.'+randomUUID()+'.tmp';
+  try{const file=await open(temporary,'wx',0o600);try{await file.writeFile(JSON.stringify(value));}finally{await file.close();}await rename(temporary,filename);return true;}finally{await rm(temporary,{force:true});}
+}
+export async function invalidateDevRouteCache({root,directory,session,buildId,paths,signal,fetcher=fetch}){
+  directory=await scopedDirectory(root,directory);
+  const manifest=JSON.parse(await readFile(path.join(directory,'manifest.json'),'utf8'));
+  if(manifest.dev!==true||manifest.devSession!==session||manifest.buildId!==buildId)throw Error('Development cache generation changed; retry');
+  if(manifest.config?.cacheHandler||Object.keys(manifest.config?.cacheHandlers||{}).length)return {invalidated:false,scope:'custom-handler',reason:'Custom cache handlers must be invalidated through their own API.',persistentTransformsPreserved:true,generationPreserved:true};
+  const filename=path.join(directory,name),info=await lstat(filename).catch(()=>null);
+  if(!info)return {invalidated:false,scope:'native-route-cache',reason:'No active runtime cache yet. Visit the route first.',persistentTransformsPreserved:true,generationPreserved:true};
+  if(!info.isFile()||info.isSymbolicLink()||info.size>4096||process.platform!=='win32'&&(info.mode&0o077))throw Error('Invalid private development cache connection');
+  const file=await open(filename,constants.O_RDONLY|(constants.O_NOFOLLOW||0));let capability;
+  try{const stat=await file.stat();if(stat.ino!==info.ino||!stat.isFile()||stat.size>4096)throw Error('Development cache connection changed');capability=JSON.parse(await file.readFile('utf8'));}finally{await file.close();}
+  if(capability.version!==1||capability.session!==session||capability.buildId!==buildId||!/^[a-f\d]{64}$/i.test(capability.token||''))throw Error('Development cache connection changed; retry');
+  const associations=[...new Set(paths.map(value=>'page:'+normalizeDevCachePath(value)))];if(!associations.length||associations.length>2)throw Error('A targeted development route is required');
+  const timeout=AbortSignal.timeout(5000),combined=signal?AbortSignal.any([signal,timeout]):timeout;
+  const response=await fetcher(endpoint(capability.endpoint),{method:'POST',redirect:'error',headers:{'content-type':'application/json',authorization:'Bearer '+capability.token},body:JSON.stringify({op:'invalidate',paths:associations,mode:'expire'}),signal:combined});
+  if(!response.ok){await response.body?.cancel();throw Error('Development cache invalidation failed ('+response.status+')');}
+  const body=await response.text();if(Buffer.byteLength(body)>16384)throw Error('Invalid development cache reply');JSON.parse(body);
+  return {invalidated:true,scope:'native-route-cache',paths:associations.map(value=>value.slice(5)),persistentTransformsPreserved:true,generationPreserved:true,customHandlersInvalidated:false};
+}

package/runtime/dev-client.mjs

@@ -1,51 +1,124 @@
 import Refresh from 'react-refresh/runtime';
+import { createDevIndicator } from './dev-indicator.mjs';
+import { createConsoleCapture, isDevicePreview } from './dev-console.mjs';
+import { createDevToolsClient } from './dev-tools-client.mjs';
+import { createDevErrorOverlay } from './dev-error-overlay.mjs';
+import { collectDevIssues, formatDevIssuesForAI } from './dev-error-report.mjs';
 
 const state = globalThis.__PRNEXT_DEV__ ||= {
   applications: new Map(), modules: new Map(), buildId: null, manifest: null,
   pending: null, applying: false, unsafe: false, queued: null, source: null,
 };
+// Install before application bootstrap so initial renders/effects are captured.
+if (!state.consoleCapture && !state.consoleDisabled) state.consoleCapture = createConsoleCapture();
 if (!state.injected) { Refresh.injectIntoGlobalHook(globalThis); state.injected = true; }
 export const register = (type, id) => Refresh.register(type, id);
 export const signature = () => Refresh.createSignatureFunctionForTransform();
 export function registerModule(id, hash, boundary) {
   const previous = state.modules.get(id);
+  if (state.applying && (!previous || previous.hash !== hash)) state.refreshSourceChanged = true;
   if (previous && previous.hash !== hash && (!previous.boundary || !boundary)) state.unsafe = true;
   state.modules.set(id, { hash, boundary });
 }
 
-function clearError() { document.getElementById('__prnext_dev_error__')?.remove(); state.overlayError = undefined; }
+function clearError({ dismiss = false } = {}) {
+  state.errorOverlay?.dispose();state.errorOverlay=undefined;
+  document.getElementById('__prnext_dev_error__')?.remove(); state.overlayError = undefined;
+  clearTimeout(state.errorCopyTimer);state.errorCopyTimer=undefined;
+  state.errorEntry=undefined;state.errorReport=undefined;state.errorSource=undefined;
+  state.overlaySelectedId=undefined;state.overlayKind=undefined;state.overlayIssues=undefined;state.errorSources=undefined;
+  if (!dismiss) state.issue = undefined;
+  state.indicator?.update();
+}
+function dismissError() {
+  if(state.overlayError&&typeof state.overlayError==='object')(state.dismissedErrors ||= new WeakSet()).add(state.overlayError);
+  const key=errorKey(state.overlayError);
+  if(key){const entries=state.dismissedDigests ||= new Set();if(entries.size>=32)entries.delete(entries.values().next().value);entries.add(key);}
+  if(state.overlayKind==='typescript')state.dismissedTypeDiagnostic=state.lastTypeDiagnostic;
+  clearError({dismiss:true});
+  let focused=document.activeElement;
+  while(focused?.shadowRoot?.activeElement)focused=focused.shadowRoot.activeElement;
+  if(!focused||focused===document.body||focused===document.documentElement||focused.closest?.('[inert]'))document.getElementById('__prnext_dev_tools__')?.shadowRoot?.querySelector('.trigger')?.focus({preventScroll:true});
+}
 function errorKey(error) {
   return typeof error?.digest === 'string' ? `${error.digest.slice(0, 256)}:${String(error.message || '').slice(0, 512)}` : null;
 }
-function showError(error) {
+function reportRecoverableError(error, info) {
+  const message=String(error?.message||error).slice(0,48*1024);
+  const key=message.replace(/^(?:Uncaught\s+)?Error:\s*/,'').split(/\n\s+at\s+/)[0].replace(/\r\n/g,'\n').trim();
+  if(state.recoverableKey===key)return;
+  // Keep one current diagnostic; the console retains the complete history.
+  // Never replace a blocking issue or open an overlay during successful recovery.
+  state.recoverableKey=key;
+  state.recoverableIssue={name:String(error?.name||'Error'),message,stack:String(error?.stack||message+(info?.componentStack||'')).slice(0,48*1024)};
+  if(state.errorOverlay)syncErrorOverlay();
+  state.indicator?.update();
+}
+function showError(error, { retain = true } = {}) {
+  if(error===null||error===undefined)error=new Error(String(error));
   const key = errorKey(error);
   if (error && typeof error === 'object' && (state.dismissedErrors?.has(error) || (key && state.dismissedDigests?.has(key)))) return;
-  state.overlayError = error;
-  let host = document.getElementById('__prnext_dev_error__');
-  if (!host) {
-    host = document.createElement('div'); host.id = '__prnext_dev_error__';
-    Object.assign(host.style, { position: 'fixed', inset: '0', zIndex: '2147483647' });
-    const shadow = host.attachShadow({ mode: 'open' });
-    const style = document.createElement('style');
-    style.textContent = ':host{color-scheme:dark}section{box-sizing:border-box;overflow:auto;height:100%;padding:32px;background:#17191fee;color:#f4f5f7;font:14px/1.6 ui-monospace,monospace}h1{font:600 22px system-ui;color:#ff7474}pre{white-space:pre-wrap;overflow-wrap:anywhere}button{position:fixed;right:24px;top:24px;padding:8px 14px;border:1px solid #697080;border-radius:6px;background:#292e39;color:white;cursor:pointer}';
-    const section = document.createElement('section'); section.setAttribute('role', 'alertdialog'); section.setAttribute('aria-label', 'PRNext development error');
-    const heading = document.createElement('h1'); heading.textContent = 'PRNext — development error';
-    const close = document.createElement('button'); close.textContent = 'Dismiss'; close.onclick = () => {
-      // React may report the same failed model again while its boundary retries.
-      // Closing that diagnostic must not block the recovered application.
-      if (state.overlayError && typeof state.overlayError === 'object') (state.dismissedErrors ||= new WeakSet()).add(state.overlayError);
-      const key = errorKey(state.overlayError);
-      if (key) {
-        const entries = state.dismissedDigests ||= new Set();
-        if (entries.size >= 32) entries.delete(entries.values().next().value);
-        entries.add(key);
-      }
-      clearError();
-    };
-    const details = document.createElement('pre'); details.id = 'details';
-    section.append(heading, close, details); shadow.append(style, section); document.documentElement.append(host);
+  if(retain){state.issue=error;if(error!==state.lastTypeDiagnostic)state.issueKind=state.devBuildState==='error'?'build':'runtime';}
+  state.indicator?.update();
+  syncErrorOverlay({preferredError:error,open:true});
+}
+function hasCriticalIssue(){return state.issue!==undefined&&state.issue!==state.lastTypeDiagnostic;}
+function syncErrorOverlay({preferredError,selectedId,open=false}={}) {
+  if(!open&&!state.errorOverlay)return;
+  const {issues,omitted}=collectDevIssues({critical:hasCriticalIssue()?state.issue:undefined,criticalKind:state.issueKind||'runtime',typeErrors:state.typeErrors,recoverable:state.recoverableIssue});
+  if(!issues.length){clearError();return;}
+  const selected=issues.find(issue=>issue.id===selectedId)
+    ||issues.find(issue=>issue.error===preferredError)
+    ||(preferredError===state.lastTypeDiagnostic&&preferredError!==undefined?issues.find(issue=>issue.kind==='typescript'&&issue.id===state.overlaySelectedId)||issues.find(issue=>issue.kind==='typescript'):undefined)
+    ||issues.find(issue=>issue.id===state.overlaySelectedId)||issues[0];
+  const changed=!state.errorOverlay?.host.isConnected||!state.errorEntry||state.errorEntry.id!==selected.id||state.errorEntry.error!==selected.error||state.errorReport.message!==selected.report.message||state.errorReport.stack!==selected.report.stack||state.overlayKind!==selected.kind;
+  state.overlayIssues={issues,omitted};state.overlaySelectedId=selected.id;state.overlayKind=selected.kind;state.overlayError=selected.error;
+  const sources=state.errorSources ||= new Map();for(const [id,cached]of sources)if(!issues.some(issue=>issue.id===id&&issue.error===cached.error&&issue.report.message===cached.report?.message&&issue.report.stack===cached.report?.stack))sources.delete(id);
+  if(!state.errorOverlay?.host.isConnected){
+    state.errorOverlay?.dispose();
+    state.errorOverlay=createDevErrorOverlay({onDismiss:dismissError,onSendToAI(){
+      const detail={kind:'error',error:state.errorReport,source:state.errorSource};
+      dismissError();
+      globalThis.dispatchEvent(new CustomEvent('prnext:devtools:ai',{detail}));
+    },onSelectIssue(id){syncErrorOverlay({selectedId:id});},onCopyForAI(){void copyErrorsForAI();}});
   }
-  host.shadowRoot.getElementById('details').textContent = String(error?.stack || error?.message || error).slice(0, 48 * 1024);
+  const overlay=state.errorOverlay;
+  if(changed){state.errorEntry=selected;state.errorReport=selected.report;state.errorSource=undefined;}
+  overlay.render(state.errorReport,{recoverable:selected.recoverable,kind:selected.kind,issues,selectedId:selected.id,omitted});
+  if(!changed)return;
+  const entry=state.errorEntry,cached=sources.get(selected.id);
+  if(cached){state.errorSource=cached.source;overlay.setSource(cached.source);overlay.setSourceStatus(cached.source.mapped?'':'Original source location.');return;}
+  overlay.setSourceStatus(state.tools?'Locating original source…':'');
+  if(state.tools)void state.tools.call('dev_source',{stack:state.errorReport.stack,error:state.errorReport}).then(source=>{
+    if(state.errorEntry!==entry||state.errorOverlay!==overlay||!overlay.host.isConnected)return;
+    sources.set(selected.id,{error:selected.error,report:entry.report,source});
+    state.errorSource=source;overlay.setSource(source);
+    overlay.setSourceStatus(source.mapped?'':'Original source location.');
+  }).catch(()=>{if(state.errorEntry===entry&&state.errorOverlay===overlay&&overlay.host.isConnected)overlay.setSourceStatus('Original source unavailable. Full details remain below.');});
+}
+async function copyErrorsForAI(){
+  const overlay=state.errorOverlay,current=state.overlayIssues;if(!overlay||!current)return;
+  try{
+    const sourceById=new Map([...(state.errorSources||[])].map(([id,cached])=>[id,cached.source]));
+    const prompt=formatDevIssuesForAI(current.issues,{route:location.pathname,sourceById,omitted:current.omitted});
+    if(!navigator.clipboard?.writeText)throw Error('Clipboard unavailable');
+    await navigator.clipboard.writeText(prompt);
+    if(state.errorOverlay===overlay){overlay.setCopyStatus('copied');clearTimeout(state.errorCopyTimer);state.errorCopyTimer=setTimeout(()=>{if(state.errorOverlay===overlay)overlay.setCopyStatus('idle');},1800);}
+  }catch{if(state.errorOverlay===overlay)overlay.setCopyStatus('error');}
+}
+
+function reload(reason) {
+  try{sessionStorage.setItem('__prnext_reload_reason__',reason);}catch{}
+  void state.tools?.browser('reload',{reason});
+  globalThis.dispatchEvent(new CustomEvent('prnext:reload',{detail:{reason}}));
+  location.reload();
+}
+function showReloadReason(){
+  let reason;try{reason=sessionStorage.getItem('__prnext_reload_reason__');sessionStorage.removeItem('__prnext_reload_reason__');}catch{}
+  if(!reason)return;
+  const note=document.createElement('div');note.id='__prnext_reload_reason__';note.setAttribute('role','status');note.textContent=reason;
+  Object.assign(note.style,{position:'fixed',bottom:'76px',left:'18px',maxWidth:'min(360px,calc(100vw - 36px))',padding:'10px 14px',border:'1px solid #292929',borderRadius:'10px',background:'#080808',color:'#ddd',font:'12px/1.5 system-ui',zIndex:'2147483646'});
+  document.documentElement.append(note);setTimeout(()=>note.remove(),6500);
 }
 
 async function updateStyles(urls) {
@@ -62,12 +135,54 @@ async function updateStyles(urls) {
   for (const link of old) if (!wanted.has(link.href)) link.remove();
 }
 
-async function applyUpdate(message) {
-  if (state.applying) { state.queued = message; return; }
-  if (!message.clientManifest) { location.reload(); return; }
+function typeDiagnostics(errors) {
+  state.typeErrors=errors;
+  if(!errors.length){
+    if(state.lastTypeDiagnostic!==undefined&&state.issue===state.lastTypeDiagnostic){
+      state.issue=undefined;
+    }
+    state.lastTypeDiagnostic=undefined;state.dismissedTypeDiagnostic=undefined;if(state.errorOverlay)syncErrorOverlay();state.indicator?.update();return;
+  }
+  const text=errors.join('\n');
+  const previous=state.lastTypeDiagnostic;
+  const critical=state.issue!==undefined&&state.issue!==previous;
+  state.lastTypeDiagnostic=text;
+  if(!critical)state.issue=text;
+  if(!critical&&state.dismissedTypeDiagnostic!==text&&(!state.overlayError||state.overlayKind==='typescript'))showError(text);
+  else if(state.errorOverlay)syncErrorOverlay();
+  state.indicator?.update();
+}
+async function applyUpdate(message, {navigation=false}={}) {
+  if(message.session&&state.session&&message.session!==state.session){reload('Development server restarted. Page reloaded.');return;}
+  if(message.sequence&&message.sequence<=(state.sequence||0))return;
+  if (state.applying) {
+    if(!state.queued||(message.sequence||0)>=(state.queued.sequence||0))state.queued={...message,navigation};
+    const pending=state.applied;await pending;
+    if((message.sequence||0)>(state.sequence||0)&&state.applying)await state.applied;
+    return;
+  }
+  if (!message.clientManifest) { reload('Refresh metadata changed. Page reloaded.'); return; }
   const changed = message.changed || [];
-  if (changed.some(file => /(?:^|\/)(?:(?:next|prnext)\.config\.|package(?:-lock)?\.json|\.env|pages\/_document\.)/.test(file))) { location.reload(); return; }
-  state.applying = true; state.unsafe = false; state.pending = null;
+  if (changed.some(file => /(?:^|\/)(?:(?:next|prnext)\.config\.|package(?:-lock)?\.json|\.env|pages\/_document\.)/.test(file))) { reload('Project configuration changed. Page reloaded.'); return; }
+  // An initial dynamic import/bootstrap failure has no mounted application to
+  // update. Retry once on a newer successfully compiled build, not repeatedly
+  // on reconnects or readiness messages for the same failed generation.
+  if(state.bootstrapFailed&&message.buildId!==state.bootstrapFailed.buildId){
+    state.bootstrapFailed=undefined;
+    reload('Application startup failed. Page reloaded after a successful rebuild.');return;
+  }
+  const refreshStarted=performance.now();
+  const localPath=location.pathname.slice((state.basePath||'').length)||'/';
+  const affected=message.affectedRoutes;
+  if(state.confirmed&&affected&&!affected.some(pattern=>pattern.includes('[')||pattern===localPath||pattern+'/'===localPath)){
+    state.buildId=message.buildId;state.sequence=message.sequence;state.lastRefresh={buildId:message.buildId,durationMs:0,changed,skipped:true};
+    document.documentElement.dataset.prnextDevBuild=message.buildId;
+    if(hasCriticalIssue()&&state.issueKind==='build'){clearError();if(state.typeErrors)typeDiagnostics(state.typeErrors);}
+    state.indicator?.update();
+    globalThis.dispatchEvent(new CustomEvent('prnext:refresh',{detail:state.lastRefresh}));return;
+  }
+  state.applying = true; state.confirmed=false; state.unsafe = false; state.refreshSourceChanged = false; state.pending = null; state.indicator?.update();
+  let applied;state.applied=new Promise(resolve=>{applied=resolve;});
   state.dismissedErrors = new WeakSet();
   state.dismissedDigests = new Set();
   try {
@@ -79,51 +194,130 @@ async function applyUpdate(message) {
     const application = await state.applications.get(kind);
     const route = kind === 'pages' ? manifest.pages.find(route => route.pattern === application.router.snapshot().pathname) : null;
     const entry = kind === 'pages' ? route?.client : manifest.app?.client;
-    if (!entry) { location.reload(); return; }
-    await import(/* webpackIgnore: true */ entry);
+    if (!entry) { reload('The current route changed. Page reloaded.'); return; }
+    if(!message.cssOnly)await import(/* webpackIgnore: true */ entry);
     const pending = state.pending;
     if (pending) await application.devPrepare?.(pending.options);
-    if (state.unsafe) { location.reload(); return; }
+    if (state.unsafe) { reload('An edited module exports values outside React components. Page reloaded.'); return; }
     await updateStyles(kind === 'pages' ? route.css : manifest.app.css);
-    clearError();
-    Refresh.performReactRefresh();
-    if (pending) await application.devCommit?.(pending.options);
+    // An unrelated type-only edit may publish a new generation without changing
+    // any browser module. Keep its existing runtime/hydration issues and current
+    // selection until application code changes, rather than racing diagnostics.
+    if(state.refreshSourceChanged||navigation){
+      state.recoverableIssue=undefined;state.recoverableKey=undefined;
+      clearError();
+    }else if(hasCriticalIssue()&&(state.issueKind==='build'||errorKey(state.issue))){
+      clearError();
+    }
+    if(!message.cssOnly)Refresh.performReactRefresh();
+    if (pending) await (navigation ? application.devSync?.(pending.options) : application.devCommit?.(pending.options));
     state.buildId = message.buildId;
+    if(message.sequence)state.sequence=message.sequence;
     state.manifest = manifest;
     document.documentElement.dataset.prnextDevBuild = message.buildId;
-    globalThis.dispatchEvent(new CustomEvent('prnext:refresh', { detail: { buildId: message.buildId } }));
+    state.lastRefresh={buildId:message.buildId,durationMs:Math.round(performance.now()-refreshStarted),changed};
+    await painted();state.confirmed=true;
+    globalThis.dispatchEvent(new CustomEvent('prnext:refresh', { detail: state.lastRefresh }));
+    globalThis.dispatchEvent(new CustomEvent('prnext:devtools:ready'));
+    if(state.typeErrors)typeDiagnostics(state.typeErrors);
   } catch (error) { showError(error); }
   finally {
-    state.applying = false; state.pending = null;
-    if (state.queued) { const queued = state.queued; state.queued = null; if (queued.buildId !== state.buildId) void applyUpdate(queued); }
+    state.applying = false; state.pending = null; state.indicator?.update();
+    applied();
+    if (state.queued) { const queued = state.queued; state.queued = null; if (queued.buildId !== state.buildId) void applyUpdate(queued,{navigation:queued.navigation}); }
   }
 }
 
 function connect(options) {
+  state.basePath=options.basePath||'';
   if (state.source) return;
   state.buildId = options.dev.buildId;
-  const source = new EventSource(`${options.basePath || ''}/_prnext/dev`);
+  state.sequence=options.dev.sequence||0;state.session=options.dev.session;
+  state.clientId ||= crypto.randomUUID();
+  state.onDemand=options.dev.onDemand===true;
+  state.devConnection = 'connecting'; state.devBuildState = 'ready';
+  if (options.dev.indicator === false) { state.consoleCapture?.dispose(); state.consoleCapture = null; state.consoleDisabled = true; }
+  const snapshot=()=>({connection:state.devConnection,building:state.devBuildState==='building'||state.applying,confirmed:state.confirmed===true,router:state.currentKind,buildId:state.buildId,sequence:state.sequence,typeErrors:state.typeErrors?.length||0,issues:(state.typeErrors?.length||0)+(hasCriticalIssue()?1:0)+(state.recoverableIssue?1:0),criticalIssues:hasCriticalIssue()?1:0,lastRefresh:state.lastRefresh});
+  state.tools ||= createDevToolsClient({capture:state.consoleCapture,snapshot,config:options.dev.tools||options.devTools});
+  showReloadReason();
+  if (options.dev.indicator !== false && !isDevicePreview() && !state.indicator) state.indicator = createDevIndicator({
+    tools:state.tools,
+    position: options.dev.indicator?.position,
+    capture: state.consoleCapture,
+    snapshot: () => ({
+      connection: state.devConnection, building: state.devBuildState === 'building' || state.applying,
+      router: state.currentKind, buildId: state.buildId, sequence: state.sequence,
+      typeErrors: state.typeErrors?.length || 0,
+      issues: (state.typeErrors?.length || 0) + (hasCriticalIssue() ? 1 : 0) + (state.recoverableIssue ? 1 : 0),
+      criticalIssues: hasCriticalIssue() ? 1 : 0,
+    }),
+    showIssues() {
+      const critical=hasCriticalIssue();
+      const error = critical?state.issue:state.recoverableIssue||state.issue||state.lastTypeDiagnostic;
+      if (error===undefined||error===null) return;
+      if (typeof error === 'object') state.dismissedErrors?.delete(error);
+      const key = errorKey(error); if (key) state.dismissedDigests?.delete(key);
+      state.dismissedTypeDiagnostic = undefined; showError(error,{retain:error!==state.recoverableIssue});
+      state.errorOverlay?.focusDismiss();
+    },
+  });
+  if (isDevicePreview()) { try { parent.postMessage({type:'prnext:preview-ready'}, location.origin); } catch {} }
+  state.ensureRoute=async raw=>{
+    if(!state.onDemand)return;
+    const url=new URL(raw,location.href);if(url.origin!==location.origin)return;
+    state.ensuring=(state.ensuring||0)+1;
+    try{
+    const response=await fetch(`${options.basePath||''}/_prnext/ensure?client=${state.clientId}&path=${encodeURIComponent(url.pathname+url.search)}`,{cache:'no-store',credentials:'same-origin'});
+    if(!response.ok)throw Error(await response.text());
+    const update=await response.json();
+    if(update.buildId!==state.buildId)await applyUpdate(update,{navigation:true});
+    }finally{state.ensuring--;}
+  };
+  const source = new EventSource(`${options.basePath || ''}/_prnext/dev?client=${state.clientId}&path=${encodeURIComponent(location.pathname+location.search)}`);
   state.source = source;
+  source.onopen = () => { state.devConnection = 'connected'; state.indicator?.update(); };
+  source.onerror = () => { state.devConnection = 'reconnecting'; state.indicator?.update(); };
   source.onmessage = event => {
     let message; try { message = JSON.parse(event.data); } catch { return; }
+    if(message.session&&state.session&&message.session!==state.session){reload('Development server restarted. Page reloaded.');return;}
+    state.devBuildState = message.state; state.indicator?.update();
+    if(Array.isArray(message.typeErrors))typeDiagnostics(message.typeErrors);
     if (message.state === 'error') { showError(message.error || 'Build failed'); return; }
     if (message.state !== 'ready') return;
     if (message.buildId === state.buildId) return;
-    void applyUpdate(message);
+    // A cold navigation may receive SSE readiness before its ensure response.
+    // Updating modules is safe; refreshing the old route would cancel the click.
+    void applyUpdate(message,{navigation:state.ensuring>0});
   };
   globalThis.addEventListener('error', event => { if (event.error) showError(event.error); });
   globalThis.addEventListener('unhandledrejection', event => showError(event.reason));
-  globalThis.addEventListener('pagehide', () => source.close(), { once: true });
+  globalThis.addEventListener('pagehide', () => {source.close();state.tools?.dispose();state.stopHydrationDiagnostics?.();}, { once: true });
 }
 
 state.reportError = showError;
+state.reportRecoverableError = reportRecoverableError;
+if(state.consoleCapture&&!state.stopHydrationDiagnostics){
+  let serial=0;
+  // Attribute-only hydration mismatches are reported by React through console,
+  // without invoking onRecoverableError. Match its diagnostic, not arbitrary logs.
+  state.stopHydrationDiagnostics=state.consoleCapture.subscribe(()=>{
+    for(const entry of state.consoleCapture?.snapshot().entries||[]){
+      if(entry.id<=serial)continue;serial=entry.id;
+      if((entry.level==='error'||entry.level==='warn')&&entry.text.includes('https://react.dev/link/hydration-mismatch')&&/Hydration failed|A tree hydrated/i.test(entry.text))reportRecoverableError(entry.text);
+    }
+  });
+}
+function painted(){return new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve)));}
 state.bootstrap = (kind, options, start) => {
   state.currentKind = kind;
   if (!state.applications.has(kind)) {
+    state.confirmed=false;
     const application = Promise.resolve().then(start);
     state.applications.set(kind, application);
     connect(options);
-    application.catch(showError);
+    application.then(async current=>{await current.devReady;await painted();if(!state.applying){state.confirmed=true;globalThis.dispatchEvent(new CustomEvent('prnext:devtools:ready'));}},error=>{
+      state.bootstrapFailed={kind,buildId:options.dev.buildId};state.confirmed=false;showError(error);
+    }).catch(showError);
   } else if (state.applying) state.pending = { kind, options };
   return state.applications.get(kind);
 };

package/runtime/dev-console-copy.mjs

@@ -0,0 +1,19 @@
+export function consolePrompt(entries, {kind='logs',version,route='/',source='Page',dropped=0}={}) {
+  const groups = new Map();
+  const hasServer=entries.some(entry=>entry.source==='server');
+  for (const entry of entries) {
+    const key = (entry.source||'browser')+'\0'+entry.level + '\0' + entry.text;
+    const group = groups.get(key);
+    if (group) group.count++;
+    else groups.set(key,{entry,count:1});
+  }
+  const instruction = kind === 'errors' ? 'Fix all errors below.' : kind === 'message' ? `Investigate the ${hasServer?'server':'client'} message below and fix its root cause if it indicates a problem.` : `Review the ${hasServer?'development':'client'} logs below and fix the errors they reveal.`;
+  // The report deliberately omits URL query/fragment and browser/session data.
+  let path='/';try{path=new URL(route,'http://prnext.local').pathname;}catch{}
+  const header = [instruction,'','Context:',`- Framework: PRNext ${version || ''}`.trimEnd(),`- Route: ${path}`,`- Source: ${source} ${hasServer?'development console (browser and server)':'client console'}`,`- Captured messages: ${entries.length} (${groups.size} unique)`];
+  if(dropped)header.push('- Earlier messages were removed from the bounded console buffer.');
+  header.push('','Diagnostic messages:');
+  for (const {entry,count} of groups.values()) header.push('',`--- ${entry.level.toUpperCase()}${hasServer?' · '+(entry.source||'browser'):''}${count>1?` · ${count} occurrences`:''} ---`,entry.text);
+  header.push('','Find the root cause, make the smallest safe code changes, preserve intended behavior, and run the relevant checks.');
+  return header.join('\n');
+}