feat: init

This commit is contained in:
2026-02-13 22:02:30 +01:00
commit 8f9ff830fb
16711 changed files with 3307340 additions and 0 deletions

View File

@@ -0,0 +1,3 @@
import type { H3Event } from "h3";
import type { AppConfig } from "@nuxt/schema";
export declare function useAppConfig(event?: H3Event): AppConfig;

View File

@@ -0,0 +1,31 @@
import { klona } from "klona";
// @ts-expect-error virtual file
import _inlineAppConfig from "#internal/nuxt/app-config";
// App config
const _sharedAppConfig = _deepFreeze(klona(_inlineAppConfig));
export function useAppConfig(event) {
// Backwards compatibility with ambient context
if (!event) {
return _sharedAppConfig;
}
event.context.nuxt ||= {};
// Reuse cached app config from event context
if (event.context.nuxt.appConfig) {
return event.context.nuxt.appConfig;
}
// Prepare app config for event context
const appConfig = klona(_inlineAppConfig);
event.context.nuxt.appConfig = appConfig;
return appConfig;
}
// --- Utils ---
function _deepFreeze(object) {
const propNames = Object.getOwnPropertyNames(object);
for (const name of propNames) {
const value = object[name];
if (value && typeof value === "object") {
_deepFreeze(value);
}
}
return Object.freeze(object);
}

View File

@@ -0,0 +1,42 @@
// @ts-check
import crypto from 'node:crypto'
import { defineDriver } from 'unstorage'
import fsDriver from 'unstorage/drivers/fs-lite'
import lruCache from 'unstorage/drivers/lru-cache'
/**
* @param {string} item
*/
function normalizeFsKey (item) {
const safe = item.replace(/[^\w.-]/g, '_')
const prefix = safe.slice(0, 20)
const hash = crypto.createHash('sha256').update(item).digest('hex')
return `${prefix}-${hash}`
}
export default defineDriver(
/**
* @param {{ base?: string }} opts
*/
(opts) => {
const fs = fsDriver({ base: opts.base })
const lru = lruCache({ max: 1000 })
return {
...fs, // fall back to file system - only the bottom three methods are used in renderer
async setItem (key, value, opts) {
await Promise.all([
fs.setItem?.(normalizeFsKey(key), value, opts),
lru.setItem?.(key, value, opts),
])
},
async hasItem (key, opts) {
return await lru.hasItem(key, opts) || await fs.hasItem(normalizeFsKey(key), opts)
},
async getItem (key, opts) {
return await lru.getItem(key, opts) || await fs.getItem(normalizeFsKey(key), opts)
},
}
},
)

View File

@@ -0,0 +1,5 @@
export declare const payloadCache: unknown;
export declare const islandCache: unknown;
export declare const islandPropCache: unknown;
export declare const sharedPrerenderPromises: unknown;
export declare const sharedPrerenderCache: unknown;

View File

@@ -0,0 +1,20 @@
import { useStorage } from "nitropack/runtime";
// @ts-expect-error virtual file
import { NUXT_SHARED_DATA } from "#internal/nuxt/nitro-config.mjs";
export const payloadCache = import.meta.prerender ? useStorage("internal:nuxt:prerender:payload") : null;
export const islandCache = import.meta.prerender ? useStorage("internal:nuxt:prerender:island") : null;
export const islandPropCache = import.meta.prerender ? useStorage("internal:nuxt:prerender:island-props") : null;
export const sharedPrerenderPromises = import.meta.prerender && NUXT_SHARED_DATA ? new Map() : null;
const sharedPrerenderKeys = new Set();
export const sharedPrerenderCache = import.meta.prerender && NUXT_SHARED_DATA ? {
get(key) {
if (sharedPrerenderKeys.has(key)) {
return sharedPrerenderPromises.get(key) ?? useStorage("internal:nuxt:prerender:shared").getItem(key);
}
},
async set(key, value) {
sharedPrerenderKeys.add(key);
sharedPrerenderPromises.set(key, value);
useStorage("internal:nuxt:prerender:shared").setItem(key, await value).finally(() => sharedPrerenderPromises.delete(key));
}
} : null;

View File

@@ -0,0 +1 @@
export declare const defineAppConfig: unknown;

View File

@@ -0,0 +1 @@
export const defineAppConfig = (config) => config;

View File

@@ -0,0 +1,3 @@
export declare function generateErrorOverlayHTML(html: string, options?: {
startMinimized?: boolean;
}): string;

View File

@@ -0,0 +1,985 @@
const iframeStorageBridge = (nonce) => `
(function () {
const NONCE = ${JSON.stringify(nonce)};
const memoryStore = Object.create(null);
const post = (type, payload) => {
window.parent.postMessage({ type, nonce: NONCE, ...payload }, '*');
};
const isValid = (data) => data && data.nonce === NONCE;
const mockStorage = {
getItem(key) {
return Object.hasOwn(memoryStore, key)
? memoryStore[key]
: null;
},
setItem(key, value) {
const v = String(value);
memoryStore[key] = v;
post('storage-set', { key, value: v });
},
removeItem(key) {
delete memoryStore[key];
post('storage-remove', { key });
},
clear() {
for (const key of Object.keys(memoryStore))
delete memoryStore[key];
post('storage-clear', {});
},
key(index) {
const keys = Object.keys(memoryStore);
return keys[index] ?? null;
},
get length() {
return Object.keys(memoryStore).length;
}
};
const defineLocalStorage = () => {
try {
Object.defineProperty(window, 'localStorage', {
value: mockStorage,
writable: false,
configurable: true
});
} catch {
window.localStorage = mockStorage;
}
};
defineLocalStorage();
window.addEventListener('message', (event) => {
const data = event.data;
if (!isValid(data) || data.type !== 'storage-sync-data') return;
const incoming = data.data || {};
for (const key of Object.keys(incoming))
memoryStore[key] = incoming[key];
if (typeof window.initTheme === 'function')
window.initTheme();
window.dispatchEvent(new Event('storage-ready'));
});
// Clipboard API is unavailable in data: URL iframe, so we use postMessage
document.addEventListener('DOMContentLoaded', function() {
window.copyErrorMessage = function(button) {
post('clipboard-copy', { text: button.dataset.errorText });
button.classList.add('copied');
setTimeout(function() { button.classList.remove('copied'); }, 2000);
};
});
post('storage-sync-request', {});
})();
`;
const parentStorageBridge = (nonce) => `
(function () {
const host = document.querySelector('nuxt-error-overlay');
if (!host) return;
const NONCE = ${JSON.stringify(nonce)};
const isValid = (data) => data && data.nonce === NONCE;
// Handle clipboard copy from iframe
window.addEventListener('message', function(e) {
if (isValid(e) && e.data.type === 'clipboard-copy') {
navigator.clipboard.writeText(e.data.text).catch(function() {});
}
});
const collectLocalStorage = () => {
const all = {};
for (let i = 0; i < localStorage.length; i++) {
const k = localStorage.key(i);
if (k != null) all[k] = localStorage.getItem(k);
}
return all;
};
const attachWhenReady = () => {
const root = host.shadowRoot;
if (!root)
return false;
const iframe = root.getElementById('frame');
if (!iframe || !iframe.contentWindow)
return false;
const handlers = {
'storage-set': (d) => localStorage.setItem(d.key, d.value),
'storage-remove': (d) => localStorage.removeItem(d.key),
'storage-clear': () => localStorage.clear(),
'storage-sync-request': () => {
iframe.contentWindow.postMessage({
type: 'storage-sync-data',
data: collectLocalStorage(),
nonce: NONCE
}, '*');
}
};
window.addEventListener('message', (event) => {
const data = event.data;
if (!isValid(data)) return;
const fn = handlers[data.type];
if (fn) fn(data);
});
return true;
};
if (attachWhenReady())
return;
const obs = new MutationObserver(() => {
if (attachWhenReady())
obs.disconnect();
});
obs.observe(host, { childList: true, subtree: true });
})();
`;
const errorCSS = `
:host {
--preview-width: 240px;
--preview-height: 180px;
--base-width: 1200px;
--base-height: 900px;
--z-base: 999999998;
--error-pip-left: auto;
--error-pip-top: auto;
--error-pip-right: 5px;
--error-pip-bottom: 5px;
--error-pip-origin: bottom right;
--app-preview-left: auto;
--app-preview-top: auto;
--app-preview-right: 5px;
--app-preview-bottom: 5px;
all: initial;
display: contents;
}
.sr-only {
position: absolute;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border-width: 0;
}
#frame {
position: fixed;
left: 0;
top: 0;
width: 100vw;
height: 100vh;
border: none;
z-index: var(--z-base);
}
#frame[inert] {
left: var(--error-pip-left);
top: var(--error-pip-top);
right: var(--error-pip-right);
bottom: var(--error-pip-bottom);
width: var(--base-width);
height: var(--base-height);
transform: scale(calc(240 / 1200));
transform-origin: var(--error-pip-origin);
overflow: hidden;
border-radius: calc(1200 * 8px / 240);
}
#preview {
position: fixed;
left: var(--app-preview-left);
top: var(--app-preview-top);
right: var(--app-preview-right);
bottom: var(--app-preview-bottom);
width: var(--preview-width);
height: var(--preview-height);
overflow: hidden;
border-radius: 6px;
pointer-events: none;
z-index: var(--z-base);
background: white;
display: none;
}
#preview iframe {
transform-origin: var(--error-pip-origin);
}
#frame:not([inert]) + #preview {
display: block;
}
#toggle {
position: fixed;
left: var(--app-preview-left);
top: var(--app-preview-top);
right: calc(var(--app-preview-right) - 3px);
bottom: calc(var(--app-preview-bottom) - 3px);
width: var(--preview-width);
height: var(--preview-height);
background: none;
border: 3px solid #00DC82;
border-radius: 8px;
cursor: pointer;
opacity: 0.8;
transition: opacity 0.2s, box-shadow 0.2s;
z-index: calc(var(--z-base) + 1);
display: flex;
align-items: center;
justify-content: center;
}
#toggle:hover,
#toggle:focus {
opacity: 1;
box-shadow: 0 0 20px rgba(0, 220, 130, 0.6);
}
#toggle:focus-visible {
outline: 3px solid #00DC82;
outline-offset: 0;
box-shadow: 0 0 24px rgba(0, 220, 130, 0.8);
}
#frame[inert] ~ #toggle {
left: var(--error-pip-left);
top: var(--error-pip-top);
right: calc(var(--error-pip-right) - 3px);
bottom: calc(var(--error-pip-bottom) - 3px);
cursor: grab;
}
:host(.dragging) #frame[inert] ~ #toggle {
cursor: grabbing;
}
#frame:not([inert]) ~ #toggle,
#frame:not([inert]) + #preview {
cursor: grab;
}
:host(.dragging-preview) #frame:not([inert]) ~ #toggle,
:host(.dragging-preview) #frame:not([inert]) + #preview {
cursor: grabbing;
}
#pip-close {
position: absolute;
top: 6px;
right: 6px;
width: 24px;
height: 24px;
border-radius: 50%;
border: none;
background: rgba(0, 0, 0, 0.75);
color: #fff;
font-size: 16px;
line-height: 1;
display: inline-flex;
align-items: center;
justify-content: center;
cursor: pointer;
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
pointer-events: auto;
}
#pip-close:focus-visible {
outline: 2px solid #00DC82;
outline-offset: 2px;
}
#pip-restore {
position: fixed;
right: 16px;
bottom: 16px;
padding: 8px 14px;
border-radius: 999px;
border: 2px solid #00DC82;
background: #111;
color: #fff;
font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif;
font-size: 14px;
display: inline-flex;
align-items: center;
gap: 6px;
z-index: calc(var(--z-base) + 2);
cursor: grab;
}
#pip-restore:focus-visible {
outline: 2px solid #00DC82;
outline-offset: 2px;
}
:host(.dragging-restore) #pip-restore {
cursor: grabbing;
}
#frame[hidden],
#toggle[hidden],
#preview[hidden],
#pip-restore[hidden],
#pip-close[hidden] {
display: none !important;
}
@media (prefers-reduced-motion: reduce) {
#toggle {
transition: none;
}
}
`;
function webComponentScript(base64HTML, startMinimized) {
return `
(function () {
try {
// =========================
// Host + Shadow
// =========================
const host = document.querySelector('nuxt-error-overlay');
if (!host)
return;
const shadow = host.attachShadow({ mode: 'open' });
// =========================
// DOM helpers
// =========================
const el = (tag) => document.createElement(tag);
const on = (node, type, fn, opts) => node.addEventListener(type, fn, opts);
const hide = (node, v) => node.toggleAttribute('hidden', !!v);
const setVar = (name, value) => host.style.setProperty(name, value);
const unsetVar = (name) => host.style.removeProperty(name);
// =========================
// Create DOM
// =========================
const style = el('style');
style.textContent = ${JSON.stringify(errorCSS)};
const iframe = el('iframe');
iframe.id = 'frame';
iframe.src = 'data:text/html;base64,${base64HTML}';
iframe.title = 'Detailed error stack trace';
iframe.setAttribute('sandbox', 'allow-scripts allow-same-origin');
const preview = el('div');
preview.id = 'preview';
const toggle = el('div');
toggle.id = 'toggle';
toggle.setAttribute('aria-expanded', 'true');
toggle.setAttribute('role', 'button');
toggle.setAttribute('tabindex', '0');
toggle.innerHTML = '<span class="sr-only">Toggle detailed error view</span>';
const liveRegion = el('div');
liveRegion.setAttribute('role', 'status');
liveRegion.setAttribute('aria-live', 'polite');
liveRegion.className = 'sr-only';
const pipCloseButton = el('button');
pipCloseButton.id = 'pip-close';
pipCloseButton.setAttribute('type', 'button');
pipCloseButton.setAttribute('aria-label', 'Hide error preview overlay');
pipCloseButton.innerHTML = '&times;';
pipCloseButton.hidden = true;
toggle.appendChild(pipCloseButton);
const pipRestoreButton = el('button');
pipRestoreButton.id = 'pip-restore';
pipRestoreButton.setAttribute('type', 'button');
pipRestoreButton.setAttribute('aria-label', 'Show error overlay');
pipRestoreButton.innerHTML = '<span aria-hidden="true">⟲</span><span>Show error overlay</span>';
pipRestoreButton.hidden = true;
// Order matters: #frame + #preview adjacency
shadow.appendChild(style);
shadow.appendChild(liveRegion);
shadow.appendChild(iframe);
shadow.appendChild(preview);
shadow.appendChild(toggle);
shadow.appendChild(pipRestoreButton);
// =========================
// Constants / keys
// =========================
const POS_KEYS = {
position: 'nuxt-error-overlay:position',
hiddenPretty: 'nuxt-error-overlay:error-pip:hidden',
hiddenPreview: 'nuxt-error-overlay:app-preview:hidden'
};
const CSS_VARS = {
pip: {
left: '--error-pip-left',
top: '--error-pip-top',
right: '--error-pip-right',
bottom: '--error-pip-bottom'
},
preview: {
left: '--app-preview-left',
top: '--app-preview-top',
right: '--app-preview-right',
bottom: '--app-preview-bottom'
}
};
const MIN_GAP = 5;
const DRAG_THRESHOLD = 2;
// =========================
// Local storage safe access + state
// =========================
let storageReady = true;
let isPrettyHidden = false;
let isPreviewHidden = false;
const safeGet = (k) => {
try {
return localStorage.getItem(k);
} catch {
return null;
}
};
const safeSet = (k, v) => {
if (!storageReady)
return;
try {
localStorage.setItem(k, v);
} catch {}
};
// =========================
// Sizing helpers
// =========================
const vvSize = () => {
const v = window.visualViewport;
return v ? { w: v.width, h: v.height } : { w: window.innerWidth, h: window.innerHeight };
};
const previewSize = () => {
const styles = getComputedStyle(host);
const w = parseFloat(styles.getPropertyValue('--preview-width')) || 240;
const h = parseFloat(styles.getPropertyValue('--preview-height')) || 180;
return { w, h };
};
const sizeForTarget = (target) => {
if (!target)
return previewSize();
const rect = target.getBoundingClientRect();
if (rect.width && rect.height)
return { w: rect.width, h: rect.height };
return previewSize();
};
// =========================
// Dock model + offset/alignment calculations
// =========================
const dock = { edge: null, offset: null, align: null, gap: null };
const maxOffsetFor = (edge, size) => {
const vv = vvSize();
if (edge === 'left' || edge === 'right')
return Math.max(MIN_GAP, vv.h - size.h - MIN_GAP);
return Math.max(MIN_GAP, vv.w - size.w - MIN_GAP);
};
const clampOffset = (edge, value, size) => {
const max = maxOffsetFor(edge, size);
return Math.min(Math.max(value, MIN_GAP), max);
};
const updateDockAlignment = (size) => {
if (!dock.edge || dock.offset == null)
return;
const max = maxOffsetFor(dock.edge, size);
if (dock.offset <= max / 2) {
dock.align = 'start';
dock.gap = dock.offset;
} else {
dock.align = 'end';
dock.gap = Math.max(0, max - dock.offset);
}
};
const appliedOffsetFor = (size) => {
if (!dock.edge || dock.offset == null)
return null;
const max = maxOffsetFor(dock.edge, size);
if (dock.align === 'end' && typeof dock.gap === 'number') {
return clampOffset(dock.edge, max - dock.gap, size);
}
if (dock.align === 'start' && typeof dock.gap === 'number') {
return clampOffset(dock.edge, dock.gap, size);
}
return clampOffset(dock.edge, dock.offset, size);
};
const nearestEdgeAt = (x, y) => {
const { w, h } = vvSize();
const d = { left: x, right: w - x, top: y, bottom: h - y };
return Object.keys(d).reduce((a, b) => (d[a] < d[b] ? a : b));
};
const cornerDefaultDock = () => {
const vv = vvSize();
const size = previewSize();
const offset = Math.max(MIN_GAP, vv.w - size.w - MIN_GAP);
return { edge: 'bottom', offset };
};
const currentTransformOrigin = () => {
if (!dock.edge) return null;
if (dock.edge === 'left' || dock.edge === 'top')
return 'top left';
if (dock.edge === 'right')
return 'top right';
return 'bottom left';
};
// =========================
// Persist / load dock
// =========================
const loadDock = () => {
const raw = safeGet(POS_KEYS.position);
if (!raw)
return;
try {
const parsed = JSON.parse(raw);
const { edge, offset, align, gap } = parsed || {};
if (!['left', 'right', 'top', 'bottom'].includes(edge))
return;
if (typeof offset !== 'number')
return;
dock.edge = edge;
dock.offset = clampOffset(edge, offset, previewSize());
dock.align = align === 'start' || align === 'end' ? align : null;
dock.gap = typeof gap === 'number' ? gap : null;
if (!dock.align || dock.gap == null)
updateDockAlignment(previewSize());
} catch {}
};
const persistDock = () => {
if (!dock.edge || dock.offset == null)
return;
safeSet(POS_KEYS.position, JSON.stringify({
edge: dock.edge,
offset: dock.offset,
align: dock.align,
gap: dock.gap
}));
};
// =========================
// Apply dock
// =========================
const dockToVars = (vars) => ({
set: (side, v) => host.style.setProperty(vars[side], v),
clear: (side) => host.style.removeProperty(vars[side])
});
const dockToEl = (node) => ({
set: (side, v) => { node.style[side] = v; },
clear: (side) => { node.style[side] = ''; }
});
const applyDock = (target, size, opts) => {
if (!dock.edge || dock.offset == null) {
target.clear('left');
target.clear('top');
target.clear('right');
target.clear('bottom');
return;
}
target.set('left', 'auto');
target.set('top', 'auto');
target.set('right', 'auto');
target.set('bottom', 'auto');
const applied = appliedOffsetFor(size);
if (dock.edge === 'left') {
target.set('left', MIN_GAP + 'px');
target.set('top', applied + 'px');
} else if (dock.edge === 'right') {
target.set('right', MIN_GAP + 'px');
target.set('top', applied + 'px');
} else if (dock.edge === 'top') {
target.set('top', MIN_GAP + 'px');
target.set('left', applied + 'px');
} else {
target.set('bottom', MIN_GAP + 'px');
target.set('left', applied + 'px');
}
if (!opts || opts.persist !== false)
persistDock();
};
const applyDockAll = (opts) => {
applyDock(dockToVars(CSS_VARS.pip), previewSize(), opts);
applyDock(dockToVars(CSS_VARS.preview), previewSize(), opts);
applyDock(dockToEl(pipRestoreButton), sizeForTarget(pipRestoreButton), opts);
};
const repaintToDock = () => {
if (!dock.edge || dock.offset == null)
return;
const origin = currentTransformOrigin();
if (origin)
setVar('--error-pip-origin', origin);
else
unsetVar('--error-pip-origin');
applyDockAll({ persist: false });
};
// =========================
// Hidden state + UI
// =========================
const loadHidden = () => {
const rawPretty = safeGet(POS_KEYS.hiddenPretty);
if (rawPretty != null)
isPrettyHidden = rawPretty === '1' || rawPretty === 'true';
const rawPreview = safeGet(POS_KEYS.hiddenPreview);
if (rawPreview != null)
isPreviewHidden = rawPreview === '1' || rawPreview === 'true';
};
const setPrettyHidden = (v) => {
isPrettyHidden = !!v;
safeSet(POS_KEYS.hiddenPretty, isPrettyHidden ? '1' : '0');
updateUI();
};
const setPreviewHidden = (v) => {
isPreviewHidden = !!v;
safeSet(POS_KEYS.hiddenPreview, isPreviewHidden ? '1' : '0');
updateUI();
};
const isMinimized = () => iframe.hasAttribute('inert');
const setMinimized = (v) => {
if (v) {
iframe.setAttribute('inert', '');
toggle.setAttribute('aria-expanded', 'false');
} else {
iframe.removeAttribute('inert');
toggle.setAttribute('aria-expanded', 'true');
}
};
const setRestoreLabel = (kind) => {
if (kind === 'pretty') {
pipRestoreButton.innerHTML = '<span aria-hidden="true">⟲</span><span>Show error overlay</span>';
pipRestoreButton.setAttribute('aria-label', 'Show error overlay');
} else {
pipRestoreButton.innerHTML = '<span aria-hidden="true">⟲</span><span>Show error page</span>';
pipRestoreButton.setAttribute('aria-label', 'Show error page');
}
};
const updateUI = () => {
const minimized = isMinimized();
const showPiP = minimized && !isPrettyHidden;
const showPreview = !minimized && !isPreviewHidden;
const pipHiddenByUser = minimized && isPrettyHidden;
const previewHiddenByUser = !minimized && isPreviewHidden;
const showToggle = minimized ? showPiP : showPreview;
const showRestore = pipHiddenByUser || previewHiddenByUser;
hide(iframe, pipHiddenByUser);
hide(preview, !showPreview);
hide(toggle, !showToggle);
hide(pipCloseButton, !showToggle);
hide(pipRestoreButton, !showRestore);
pipCloseButton.setAttribute('aria-label', minimized ? 'Hide error overlay' : 'Hide error page preview');
if (pipHiddenByUser)
setRestoreLabel('pretty');
else if (previewHiddenByUser)
setRestoreLabel('preview');
host.classList.toggle('pip-hidden', isPrettyHidden);
host.classList.toggle('preview-hidden', isPreviewHidden);
};
// =========================
// Preview snapshot
// =========================
const updatePreview = () => {
try {
let previewIframe = preview.querySelector('iframe');
if (!previewIframe) {
previewIframe = el('iframe');
previewIframe.style.cssText = 'width: 1200px; height: 900px; transform: scale(0.2); transform-origin: top left; border: none;';
previewIframe.setAttribute('sandbox', 'allow-scripts allow-same-origin');
preview.appendChild(previewIframe);
}
const doctype = document.doctype ? '<!DOCTYPE ' + document.doctype.name + '>' : '';
const cleanedHTML = document.documentElement.outerHTML
.replace(/<nuxt-error-overlay[^>]*>.*?<\\/nuxt-error-overlay>/gs, '')
.replace(/<script[^>]*>.*?<\\/script>/gs, '');
const iframeDoc = previewIframe.contentDocument || previewIframe.contentWindow.document;
iframeDoc.open();
iframeDoc.write(doctype + cleanedHTML);
iframeDoc.close();
} catch (err) {
console.error('Failed to update preview:', err);
}
};
// =========================
// View toggling
// =========================
const toggleView = () => {
if (isMinimized()) {
updatePreview();
setMinimized(false);
liveRegion.textContent = 'Showing detailed error view';
setTimeout(() => {
try {
iframe.contentWindow.focus();
} catch {}
}, 100);
} else {
setMinimized(true);
liveRegion.textContent = 'Showing error page';
repaintToDock();
void iframe.offsetWidth;
}
updateUI();
};
// =========================
// Dragging (unified, rAF throttled)
// =========================
let drag = null;
let rafId = null;
let suppressToggleClick = false;
let suppressRestoreClick = false;
const beginDrag = (e) => {
if (drag)
return;
if (!dock.edge || dock.offset == null) {
const def = cornerDefaultDock();
dock.edge = def.edge;
dock.offset = def.offset;
updateDockAlignment(previewSize());
}
const isRestoreTarget = e.currentTarget === pipRestoreButton;
drag = {
kind: isRestoreTarget ? 'restore' : (isMinimized() ? 'pip' : 'preview'),
pointerId: e.pointerId,
startX: e.clientX,
startY: e.clientY,
lastX: e.clientX,
lastY: e.clientY,
moved: false,
target: e.currentTarget
};
drag.target.setPointerCapture(e.pointerId);
if (drag.kind === 'restore')
host.classList.add('dragging-restore');
else
host.classList.add(drag.kind === 'pip' ? 'dragging' : 'dragging-preview');
e.preventDefault();
};
const moveDrag = (e) => {
if (!drag || drag.pointerId !== e.pointerId)
return;
drag.lastX = e.clientX;
drag.lastY = e.clientY;
const dx = drag.lastX - drag.startX;
const dy = drag.lastY - drag.startY;
if (!drag.moved && (Math.abs(dx) > DRAG_THRESHOLD || Math.abs(dy) > DRAG_THRESHOLD)) {
drag.moved = true;
}
if (!drag.moved)
return;
if (rafId)
return;
rafId = requestAnimationFrame(() => {
rafId = null;
const edge = nearestEdgeAt(drag.lastX, drag.lastY);
const size = sizeForTarget(drag.target);
let offset;
if (edge === 'left' || edge === 'right') {
const top = drag.lastY - (size.h / 2);
offset = clampOffset(edge, Math.round(top), size);
} else {
const left = drag.lastX - (size.w / 2);
offset = clampOffset(edge, Math.round(left), size);
}
dock.edge = edge;
dock.offset = offset;
updateDockAlignment(size);
const origin = currentTransformOrigin();
setVar('--error-pip-origin', origin || 'bottom right');
applyDockAll({ persist: false });
});
};
const endDrag = (e) => {
if (!drag || drag.pointerId !== e.pointerId)
return;
const endedKind = drag.kind;
drag.target.releasePointerCapture(e.pointerId);
if (endedKind === 'restore')
host.classList.remove('dragging-restore');
else
host.classList.remove(endedKind === 'pip' ? 'dragging' : 'dragging-preview');
const didMove = drag.moved;
drag = null;
if (didMove) {
persistDock();
if (endedKind === 'restore')
suppressRestoreClick = true;
else
suppressToggleClick = true;
e.preventDefault();
e.stopPropagation();
}
};
const bindDragTarget = (node) => {
on(node, 'pointerdown', beginDrag);
on(node, 'pointermove', moveDrag);
on(node, 'pointerup', endDrag);
on(node, 'pointercancel', endDrag);
};
bindDragTarget(toggle);
bindDragTarget(pipRestoreButton);
// =========================
// Events (toggle / close / restore)
// =========================
on(toggle, 'click', (e) => {
if (suppressToggleClick) {
e.preventDefault();
suppressToggleClick = false;
return;
}
toggleView();
});
on(toggle, 'keydown', (e) => {
if (e.key === 'Enter' || e.key === ' ') {
e.preventDefault();
toggleView();
}
});
on(pipCloseButton, 'click', (e) => {
e.preventDefault();
e.stopPropagation();
if (isMinimized())
setPrettyHidden(true);
else
setPreviewHidden(true);
});
on(pipCloseButton, 'pointerdown', (e) => {
e.stopPropagation();
});
on(pipRestoreButton, 'click', (e) => {
if (suppressRestoreClick) {
e.preventDefault();
suppressRestoreClick = false;
return;
}
e.preventDefault();
e.stopPropagation();
if (isMinimized())
setPrettyHidden(false);
else
setPreviewHidden(false);
});
// =========================
// Lifecycle: load / sync / repaint
// =========================
const loadState = () => {
loadDock();
loadHidden();
if (isPrettyHidden && !isMinimized())
setMinimized(true);
updateUI();
repaintToDock();
};
loadState();
on(window, 'storage-ready', () => {
storageReady = true;
loadState();
});
const onViewportChange = () => repaintToDock();
on(window, 'resize', onViewportChange);
if (window.visualViewport) {
on(window.visualViewport, 'resize', onViewportChange);
on(window.visualViewport, 'scroll', onViewportChange);
}
// initial preview
setTimeout(updatePreview, 100);
// initial minimized option
if (${startMinimized}) {
setMinimized(true);
repaintToDock();
void iframe.offsetWidth;
updateUI();
}
} catch (err) {
console.error('Failed to initialize Nuxt error overlay:', err);
}
})();
`;
}
export function generateErrorOverlayHTML(html, options) {
const nonce = Array.from(crypto.getRandomValues(new Uint8Array(16)), (b) => b.toString(16).padStart(2, "0")).join("");
const errorPage = html.replace("<head>", `<head><script>${iframeStorageBridge(nonce)}<\/script>`);
const base64HTML = Buffer.from(errorPage, "utf8").toString("base64");
return `
<script>${parentStorageBridge(nonce)}<\/script>
<nuxt-error-overlay></nuxt-error-overlay>
<script>${webComponentScript(base64HTML, options?.startMinimized ?? false)}<\/script>
`;
}

View File

@@ -0,0 +1,6 @@
import type { H3Event } from "h3";
/**
* Nitro internal functions extracted from https://github.com/nitrojs/nitro/blob/v2/src/runtime/internal/utils.ts
*/
export declare function isJsonRequest(event: H3Event): boolean;
export declare function hasReqHeader(event: H3Event, name: string, includes: string);

View File

@@ -0,0 +1,15 @@
import { getRequestHeader } from "h3";
/**
* Nitro internal functions extracted from https://github.com/nitrojs/nitro/blob/v2/src/runtime/internal/utils.ts
*/
export function isJsonRequest(event) {
// If the client specifically requests HTML, then avoid classifying as JSON.
if (hasReqHeader(event, "accept", "text/html")) {
return false;
}
return hasReqHeader(event, "accept", "application/json") || hasReqHeader(event, "user-agent", "curl/") || hasReqHeader(event, "user-agent", "httpie/") || hasReqHeader(event, "sec-fetch-mode", "cors") || event.path.startsWith("/api/") || event.path.endsWith(".json");
}
export function hasReqHeader(event, name, includes) {
const value = getRequestHeader(event, name);
return value && typeof value === "string" && value.toLowerCase().includes(includes);
}

View File

@@ -0,0 +1,4 @@
export declare function baseURL(): string;
export declare function buildAssetsDir(): string;
export declare function buildAssetsURL(...path: string[]): string;
export declare function publicAssetsURL(...path: string[]): string;

View File

@@ -0,0 +1,19 @@
import { joinRelativeURL } from "ufo";
import { useRuntimeConfig } from "nitropack/runtime";
export function baseURL() {
// TODO: support passing event to `useRuntimeConfig`
return useRuntimeConfig().app.baseURL;
}
export function buildAssetsDir() {
// TODO: support passing event to `useRuntimeConfig`
return useRuntimeConfig().app.buildAssetsDir;
}
export function buildAssetsURL(...path) {
return joinRelativeURL(publicAssetsURL(), buildAssetsDir(), ...path);
}
export function publicAssetsURL(...path) {
// TODO: support passing event to `useRuntimeConfig`
const app = useRuntimeConfig().app;
const publicBase = app.cdnURL || app.baseURL;
return path.length ? joinRelativeURL(publicBase, ...path) : publicBase;
}

View File

@@ -0,0 +1,6 @@
import type { H3Event } from "h3";
import type { NuxtPayload, NuxtSSRContext } from "nuxt/app";
export declare function createSSRContext(event: H3Event): NuxtSSRContext;
export declare function setSSRError(ssrContext: NuxtSSRContext, error: NuxtPayload["error"] & {
url: string;
}): void;

View File

@@ -0,0 +1,38 @@
import { useRuntimeConfig } from "nitropack/runtime";
import { createHead } from "@unhead/vue/server";
import { sharedPrerenderCache } from "../cache.mjs";
// @ts-expect-error virtual file
import unheadOptions from "#internal/unhead-options.mjs";
// @ts-expect-error virtual file
import { NUXT_NO_SSR, NUXT_SHARED_DATA } from "#internal/nuxt/nitro-config.mjs";
const PRERENDER_NO_SSR_ROUTES = new Set([
"/index.html",
"/200.html",
"/404.html"
]);
export function createSSRContext(event) {
const ssrContext = {
url: event.path,
event,
runtimeConfig: useRuntimeConfig(event),
noSSR: !!NUXT_NO_SSR || event.context.nuxt?.noSSR || (import.meta.prerender ? PRERENDER_NO_SSR_ROUTES.has(event.path) : false),
head: createHead(unheadOptions),
error: false,
nuxt: undefined,
payload: {},
["~payloadReducers"]: Object.create(null),
modules: new Set()
};
if (import.meta.prerender) {
if (NUXT_SHARED_DATA) {
ssrContext["~sharedPrerenderCache"] = sharedPrerenderCache;
}
ssrContext.payload.prerenderedAt = Date.now();
}
return ssrContext;
}
export function setSSRError(ssrContext, error) {
ssrContext.error = true;
ssrContext.payload = { error };
ssrContext.url = error.url;
}

View File

@@ -0,0 +1,16 @@
import type { RendererContext } from "vue-bundle-renderer/runtime";
import type { NuxtSSRContext } from "nuxt/app";
interface Renderer {
rendererContext: RendererContext;
renderToString(ssrContext: NuxtSSRContext): Promise<{
html: string;
renderResourceHeaders: () => Record<string, string>;
renderResourceHints: () => string;
renderStyles: () => string;
renderScripts: () => string;
}>;
}
export declare const getSSRRenderer: unknown;
export declare function getRenderer(ssrContext: NuxtSSRContext): Promise<Renderer>;
export declare const getSSRStyles: unknown;
export {};

View File

@@ -0,0 +1,100 @@
import { createRenderer } from "vue-bundle-renderer/runtime";
import { renderToString as _renderToString } from "vue/server-renderer";
import { propsToString } from "@unhead/vue/server";
import { useRuntimeConfig } from "nitropack/runtime";
// @ts-expect-error virtual file
import { NUXT_NO_SSR } from "#internal/nuxt/nitro-config.mjs";
// @ts-expect-error virtual file
import { appRootAttrs, appRootTag, appSpaLoaderAttrs, appSpaLoaderTag, spaLoadingTemplateOutside } from "#internal/nuxt.config.mjs";
// @ts-expect-error virtual file
import { buildAssetsURL } from "#internal/nuxt/paths";
const APP_ROOT_OPEN_TAG = `<${appRootTag}${propsToString(appRootAttrs)}>`;
const APP_ROOT_CLOSE_TAG = `</${appRootTag}>`;
// @ts-expect-error file will be produced after app build
const getServerEntry = () => import("#build/dist/server/server.mjs").then((r) => r.default || r);
// @ts-expect-error file will be produced after app build
const getClientManifest = () => import("#build/dist/server/client.manifest.mjs").then((r) => r.default || r).then((r) => typeof r === "function" ? r() : r);
// @ts-expect-error file will be produced after app build
const getPrecomputedDependencies = () => import("#build/dist/server/client.precomputed.mjs").then((r) => r.default || r).then((r) => typeof r === "function" ? r() : r);
// -- SSR Renderer --
export const getSSRRenderer = lazyCachedFunction(async () => {
// Load server bundle
const createSSRApp = await getServerEntry();
if (!createSSRApp) {
throw new Error("Server bundle is not available");
}
// Load precomputed dependencies
const precomputed = import.meta.dev ? undefined : await getPrecomputedDependencies();
// Create renderer
const renderer = createRenderer(createSSRApp, {
precomputed,
manifest: import.meta.dev ? await getClientManifest() : undefined,
renderToString,
buildAssetsURL
});
async function renderToString(input, context) {
const html = await _renderToString(input, context);
// In development with vite-node, the manifest is on-demand and will be available after rendering
// eslint-disable-next-line no-restricted-globals
if (import.meta.dev && process.env.NUXT_VITE_NODE_OPTIONS) {
renderer.rendererContext.updateManifest(await getClientManifest());
}
return APP_ROOT_OPEN_TAG + html + APP_ROOT_CLOSE_TAG;
}
return renderer;
});
// -- SPA Renderer --
const getSPARenderer = lazyCachedFunction(async () => {
const precomputed = import.meta.dev ? undefined : await getPrecomputedDependencies();
// @ts-expect-error virtual file
const spaTemplate = await import("#spa-template").then((r) => r.template).catch(() => "").then((r) => {
if (spaLoadingTemplateOutside) {
const APP_SPA_LOADER_OPEN_TAG = `<${appSpaLoaderTag}${propsToString(appSpaLoaderAttrs)}>`;
const APP_SPA_LOADER_CLOSE_TAG = `</${appSpaLoaderTag}>`;
const appTemplate = APP_ROOT_OPEN_TAG + APP_ROOT_CLOSE_TAG;
const loaderTemplate = r ? APP_SPA_LOADER_OPEN_TAG + r + APP_SPA_LOADER_CLOSE_TAG : "";
return appTemplate + loaderTemplate;
} else {
return APP_ROOT_OPEN_TAG + r + APP_ROOT_CLOSE_TAG;
}
});
// Create SPA renderer and cache the result for all requests
const renderer = createRenderer(() => () => {}, {
precomputed,
manifest: import.meta.dev ? await getClientManifest() : undefined,
renderToString: () => spaTemplate,
buildAssetsURL
});
const result = await renderer.renderToString({});
const renderToString = (ssrContext) => {
const config = useRuntimeConfig(ssrContext.event);
ssrContext.modules ||= new Set();
ssrContext.payload.serverRendered = false;
ssrContext.config = {
public: config.public,
app: config.app
};
return Promise.resolve(result);
};
return {
rendererContext: renderer.rendererContext,
renderToString
};
});
function lazyCachedFunction(fn) {
let res = null;
return () => {
if (res === null) {
res = fn().catch((err) => {
res = null;
throw err;
});
}
return res;
};
}
export function getRenderer(ssrContext) {
return NUXT_NO_SSR || ssrContext.noSSR ? getSPARenderer() : getSSRRenderer();
}
// @ts-expect-error file will be produced after app build
export const getSSRStyles = lazyCachedFunction(() => import("#build/dist/server/styles.mjs").then((r) => r.default || r));

View File

@@ -0,0 +1,2 @@
import type { Style } from "@unhead/vue/types";
export declare function renderInlineStyles(usedModules: Set<string> | string[]): Promise<Style[]>;

View File

@@ -0,0 +1,13 @@
import { getSSRStyles } from "./build-files.mjs";
export async function renderInlineStyles(usedModules) {
const styleMap = await getSSRStyles();
const inlinedStyles = new Set();
for (const mod of usedModules) {
if (mod in styleMap && styleMap[mod]) {
for (const style of await styleMap[mod]()) {
inlinedStyles.add(style);
}
}
}
return Array.from(inlinedStyles).map((style) => ({ innerHTML: style }));
}

View File

@@ -0,0 +1,9 @@
import type { NuxtIslandResponse, NuxtSSRContext } from "nuxt/app";
/**
* remove the root node from the html body
*/
export declare function getServerComponentHTML(body: string): string;
export declare function getSlotIslandResponse(ssrContext: NuxtSSRContext): NuxtIslandResponse["slots"];
export declare function getClientIslandResponse(ssrContext: NuxtSSRContext): NuxtIslandResponse["components"];
export declare function getComponentSlotTeleport(clientUid: string, teleports: Record<string, string>): Record<string, string>;
export declare function replaceIslandTeleports(ssrContext: NuxtSSRContext, html: string): string;

View File

@@ -0,0 +1,87 @@
// @ts-expect-error virtual file
import { appRootTag } from "#internal/nuxt.config.mjs";
const ROOT_NODE_REGEX = new RegExp(`^<${appRootTag}[^>]*>([\\s\\S]*)<\\/${appRootTag}>$`);
/**
* remove the root node from the html body
*/
export function getServerComponentHTML(body) {
const match = body.match(ROOT_NODE_REGEX);
return match?.[1] || body;
}
const SSR_SLOT_TELEPORT_MARKER = /^uid=([^;]*);slot=(.*)$/;
const SSR_CLIENT_TELEPORT_MARKER = /^uid=([^;]*);client=(.*)$/;
const SSR_CLIENT_SLOT_MARKER = /^island-slot=([^;]*);(.*)$/;
export function getSlotIslandResponse(ssrContext) {
if (!ssrContext.islandContext || !Object.keys(ssrContext.islandContext.slots).length) {
return undefined;
}
const response = {};
for (const [name, slot] of Object.entries(ssrContext.islandContext.slots)) {
response[name] = {
...slot,
fallback: ssrContext.teleports?.[`island-fallback=${name}`]
};
}
return response;
}
export function getClientIslandResponse(ssrContext) {
if (!ssrContext.islandContext || !Object.keys(ssrContext.islandContext.components).length) {
return undefined;
}
const response = {};
for (const [clientUid, component] of Object.entries(ssrContext.islandContext.components)) {
// remove teleport anchor to avoid hydration issues
const html = ssrContext.teleports?.[clientUid]?.replaceAll("<!--teleport start anchor-->", "") || "";
response[clientUid] = {
...component,
html,
slots: getComponentSlotTeleport(clientUid, ssrContext.teleports ?? {})
};
}
return response;
}
export function getComponentSlotTeleport(clientUid, teleports) {
const entries = Object.entries(teleports);
const slots = {};
for (const [key, value] of entries) {
const match = key.match(SSR_CLIENT_SLOT_MARKER);
if (match) {
const [, id, slot] = match;
if (!slot || clientUid !== id) {
continue;
}
slots[slot] = value;
}
}
return slots;
}
export function replaceIslandTeleports(ssrContext, html) {
const { teleports, islandContext } = ssrContext;
if (islandContext || !teleports) {
return html;
}
for (const key in teleports) {
const matchClientComp = key.match(SSR_CLIENT_TELEPORT_MARKER);
if (matchClientComp) {
const [, uid, clientId] = matchClientComp;
if (!uid || !clientId) {
continue;
}
html = html.replace(new RegExp(` data-island-uid="${uid}" data-island-component="${clientId}"[^>]*>`), (full) => {
return full + teleports[key];
});
continue;
}
const matchSlot = key.match(SSR_SLOT_TELEPORT_MARKER);
if (matchSlot) {
const [, uid, slot] = matchSlot;
if (!uid || !slot) {
continue;
}
html = html.replace(new RegExp(` data-island-uid="${uid}" data-island-slot="${slot}"[^>]*>`), (full) => {
return full + teleports[key];
});
}
}
return html;
}

View File

@@ -0,0 +1,24 @@
import type { NitroRouteRules, RenderResponse } from "nitropack/types";
import type { Script } from "@unhead/vue";
import type { NuxtPayload, NuxtSSRContext } from "nuxt/app";
export declare function renderPayloadResponse(ssrContext: NuxtSSRContext): RenderResponse;
export declare function renderPayloadJsonScript(opts: {
ssrContext: NuxtSSRContext;
data?: any;
src?: string;
}): Script[];
export declare function renderPayloadScript(opts: {
ssrContext: NuxtSSRContext;
routeOptions: NitroRouteRules;
data?: any;
src?: string;
}): Script[];
interface SplitPayload {
initial: Omit<NuxtPayload, "data">;
payload: {
data?: NuxtPayload["data"];
prerenderedAt?: NuxtPayload["prerenderedAt"];
};
}
export declare function splitPayload(ssrContext: NuxtSSRContext): SplitPayload;
export {};

View File

@@ -0,0 +1,64 @@
import { getResponseStatus, getResponseStatusText } from "h3";
import devalue from "@nuxt/devalue";
import { stringify, uneval } from "devalue";
// @ts-expect-error virtual file
import { appId, multiApp } from "#internal/nuxt.config.mjs";
// @ts-expect-error virtual file
import { NUXT_JSON_PAYLOADS, NUXT_NO_SSR, NUXT_PAYLOAD_EXTRACTION, NUXT_RUNTIME_PAYLOAD_EXTRACTION } from "#internal/nuxt/nitro-config.mjs";
export function renderPayloadResponse(ssrContext) {
return {
body: NUXT_JSON_PAYLOADS ? stringify(splitPayload(ssrContext).payload, ssrContext["~payloadReducers"]) : `export default ${devalue(splitPayload(ssrContext).payload)}`,
statusCode: getResponseStatus(ssrContext.event),
statusMessage: getResponseStatusText(ssrContext.event),
headers: {
"content-type": NUXT_JSON_PAYLOADS ? "application/json;charset=utf-8" : "text/javascript;charset=utf-8",
"x-powered-by": "Nuxt"
}
};
}
export function renderPayloadJsonScript(opts) {
const contents = opts.data ? stringify(opts.data, opts.ssrContext["~payloadReducers"]) : "";
const payload = {
"type": "application/json",
"innerHTML": contents,
"data-nuxt-data": appId,
"data-ssr": !(NUXT_NO_SSR || opts.ssrContext.noSSR)
};
if (!multiApp) {
payload.id = "__NUXT_DATA__";
}
if (opts.src) {
payload["data-src"] = opts.src;
}
const config = uneval(opts.ssrContext.config);
return [payload, { innerHTML: multiApp ? `window.__NUXT__=window.__NUXT__||{};window.__NUXT__[${JSON.stringify(appId)}]={config:${config}}` : `window.__NUXT__={};window.__NUXT__.config=${config}` }];
}
export function renderPayloadScript(opts) {
opts.data.config = opts.ssrContext.config;
const _PAYLOAD_EXTRACTION = !opts.ssrContext.noSSR && (import.meta.prerender && NUXT_PAYLOAD_EXTRACTION || NUXT_RUNTIME_PAYLOAD_EXTRACTION && (opts.routeOptions.isr || opts.routeOptions.cache));
const nuxtData = devalue(opts.data);
if (_PAYLOAD_EXTRACTION) {
const singleAppPayload = `import p from "${opts.src}";window.__NUXT__={...p,...(${nuxtData})}`;
const multiAppPayload = `import p from "${opts.src}";window.__NUXT__=window.__NUXT__||{};window.__NUXT__[${JSON.stringify(appId)}]={...p,...(${nuxtData})}`;
return [{
type: "module",
innerHTML: multiApp ? multiAppPayload : singleAppPayload
}];
}
const singleAppPayload = `window.__NUXT__=${nuxtData}`;
const multiAppPayload = `window.__NUXT__=window.__NUXT__||{};window.__NUXT__[${JSON.stringify(appId)}]=${nuxtData}`;
return [{ innerHTML: multiApp ? multiAppPayload : singleAppPayload }];
}
export function splitPayload(ssrContext) {
const { data, prerenderedAt, ...initial } = ssrContext.payload;
return {
initial: {
...initial,
prerenderedAt
},
payload: {
data,
prerenderedAt
}
};
}