@caryhu/codemine-forge 0.0.1-alpha.1 → 0.0.1-alpha.3

package/dist/build-pipeline/vite-config.js

@@ -0,0 +1,215 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readViteConfigMetadata = exports.VITE_CONFIG_PATHS = void 0;
+const ts = __importStar(require("typescript"));
+const virtual_file_system_1 = require("../virtual-file-system");
+exports.VITE_CONFIG_PATHS = [
+    "/vite.config.js",
+    "/vite.config.mjs",
+    "/vite.config.ts",
+];
+async function readViteConfigMetadata(fileSystem) {
+    const detectedPaths = [];
+    for (const path of exports.VITE_CONFIG_PATHS) {
+        if (await fileSystem.exists(path)) {
+            detectedPaths.push(path);
+        }
+    }
+    const selectedPath = detectedPaths[0];
+    if (selectedPath === undefined) {
+        return {
+            detectedPaths,
+        };
+    }
+    return {
+        detectedPaths,
+        metadata: parseViteConfigMetadata(selectedPath, await fileSystem.readText(selectedPath)),
+    };
+}
+exports.readViteConfigMetadata = readViteConfigMetadata;
+function parseViteConfigMetadata(path, source) {
+    const sourceFile = ts.createSourceFile(path, source, ts.ScriptTarget.Latest, true, scriptKindForPath(path));
+    const configObject = findDefaultConfigObject(sourceFile);
+    if (configObject === undefined) {
+        return {
+            aliases: {},
+            define: {},
+            path,
+        };
+    }
+    return {
+        aliases: parseAliasMap(configObject),
+        base: parseBase(configObject),
+        define: parseDefineMap(configObject),
+        path,
+    };
+}
+function findDefaultConfigObject(sourceFile) {
+    for (const statement of sourceFile.statements) {
+        if (!ts.isExportAssignment(statement)) {
+            continue;
+        }
+        return unwrapConfigObject(statement.expression);
+    }
+    return undefined;
+}
+function unwrapConfigObject(expression) {
+    const unwrapped = unwrapExpression(expression);
+    if (ts.isObjectLiteralExpression(unwrapped)) {
+        return unwrapped;
+    }
+    if (ts.isCallExpression(unwrapped) &&
+        unwrapped.arguments.length > 0) {
+        return unwrapConfigObject(unwrapped.arguments[0]);
+    }
+    return undefined;
+}
+function unwrapExpression(expression) {
+    if (ts.isParenthesizedExpression(expression)) {
+        return unwrapExpression(expression.expression);
+    }
+    if (ts.isAsExpression(expression) || ts.isTypeAssertionExpression(expression)) {
+        return unwrapExpression(expression.expression);
+    }
+    if (ts.isSatisfiesExpression(expression)) {
+        return unwrapExpression(expression.expression);
+    }
+    return expression;
+}
+function parseAliasMap(configObject) {
+    const resolveObject = getObjectProperty(configObject, "resolve");
+    const aliasObject = resolveObject === undefined ? undefined : getObjectProperty(resolveObject, "alias");
+    if (aliasObject === undefined) {
+        return {};
+    }
+    const aliases = {};
+    for (const property of aliasObject.properties) {
+        if (!ts.isPropertyAssignment(property)) {
+            continue;
+        }
+        const key = getPropertyNameText(property.name);
+        const value = getStringLiteralText(property.initializer);
+        const normalizedValue = value === undefined ? undefined : normalizeAliasReplacement(value);
+        if (key !== undefined && normalizedValue !== undefined) {
+            aliases[key] = normalizedValue;
+        }
+    }
+    return sortRecord(aliases);
+}
+function parseDefineMap(configObject) {
+    const defineObject = getObjectProperty(configObject, "define");
+    if (defineObject === undefined) {
+        return {};
+    }
+    const define = {};
+    for (const property of defineObject.properties) {
+        if (!ts.isPropertyAssignment(property)) {
+            continue;
+        }
+        const key = getPropertyNameText(property.name);
+        const value = getDefineValueText(property.initializer);
+        if (key !== undefined && value !== undefined) {
+            define[key] = value;
+        }
+    }
+    return sortRecord(define);
+}
+function parseBase(configObject) {
+    const baseProperty = getProperty(configObject, "base");
+    return baseProperty === undefined
+        ? undefined
+        : getStringLiteralText(baseProperty.initializer);
+}
+function getObjectProperty(object, propertyName) {
+    const property = getProperty(object, propertyName);
+    if (property === undefined) {
+        return undefined;
+    }
+    const initializer = unwrapExpression(property.initializer);
+    return ts.isObjectLiteralExpression(initializer) ? initializer : undefined;
+}
+function getProperty(object, propertyName) {
+    for (const property of object.properties) {
+        if (!ts.isPropertyAssignment(property)) {
+            continue;
+        }
+        if (getPropertyNameText(property.name) === propertyName) {
+            return property;
+        }
+    }
+    return undefined;
+}
+function getPropertyNameText(name) {
+    if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) {
+        return name.text;
+    }
+    return undefined;
+}
+function getStringLiteralText(expression) {
+    const unwrapped = unwrapExpression(expression);
+    if (ts.isStringLiteral(unwrapped) || ts.isNoSubstitutionTemplateLiteral(unwrapped)) {
+        return unwrapped.text;
+    }
+    return undefined;
+}
+function getDefineValueText(expression) {
+    const unwrapped = unwrapExpression(expression);
+    const stringText = getStringLiteralText(unwrapped);
+    if (stringText !== undefined) {
+        return stringText;
+    }
+    if (unwrapped.kind === ts.SyntaxKind.TrueKeyword) {
+        return "true";
+    }
+    if (unwrapped.kind === ts.SyntaxKind.FalseKeyword) {
+        return "false";
+    }
+    if (unwrapped.kind === ts.SyntaxKind.NullKeyword) {
+        return "null";
+    }
+    if (ts.isNumericLiteral(unwrapped)) {
+        return unwrapped.text;
+    }
+    return undefined;
+}
+function normalizeAliasReplacement(value) {
+    const path = value.startsWith("/")
+        ? value
+        : value.startsWith("./")
+            ? value.slice(1)
+            : undefined;
+    if (path === undefined) {
+        return undefined;
+    }
+    const normalized = (0, virtual_file_system_1.normalizeForgePath)(path);
+    return normalized.ok ? normalized.path : undefined;
+}
+function scriptKindForPath(path) {
+    return path.endsWith(".ts") ? ts.ScriptKind.TS : ts.ScriptKind.JS;
+}
+function sortRecord(record) {
+    return Object.fromEntries(Object.entries(record).sort(([left], [right]) => left.localeCompare(right)));
+}

package/dist/dev-server-preview/index.d.ts

@@ -1,4 +1,4 @@
 export { createMissingDevScriptDiagnostic, createSessionNotFoundDiagnostic, createSessionStoppedDiagnostic, createUnsupportedDevScriptDiagnostic, } from "./diagnostics";
-export { createForgePreviewDocument } from "./preview-document";
+export { createForgePreviewDocument, createForgePreviewErrorOverlayDocument, } from "./preview-document";
 export { createDevServerPreview, DefaultDevServerPreview, isSupportedViteDevScript, } from "./server";
-export { DEV_SERVER_PREVIEW_CAPABILITY, type ForgeCreatePreviewDocumentOptions, type ForgeDevServerPreview, type ForgeDevServerPreviewDiagnostic, type ForgeDevServerPreviewDiagnosticCode, type ForgeDevServerPreviewEvent, type ForgeDevServerPreviewEventListener, type ForgeDevServerPreviewOptions, type ForgeDevSession, type ForgeDevSessionDiagnostic, type ForgeDevSessionFailedEvent, type ForgeDevSessionFileChange, type ForgeDevSessionRefreshResult, type ForgeDevSessionStartedEvent, type ForgeDevSessionStartResult, type ForgeDevSessionStatus, type ForgeDevSessionStoppedEvent, type ForgeDevSessionStopResult, type ForgePreviewDocument, type ForgePreviewRefreshedEvent, type ForgeRebuildDevSessionOptions, type ForgeStartDevSessionOptions, } from "./types";
+export { DEV_SERVER_PREVIEW_CAPABILITY, type ForgeCreatePreviewDocumentOptions, type ForgeDevServerAdapterFramework, type ForgeDevServerAdapterHmrMode, type ForgeDevServerAdapterMetadata, type ForgeDevServerAdapterName, type ForgeDevServerPreview, type ForgeDevServerPreviewDiagnostic, type ForgeDevServerPreviewDiagnosticCode, type ForgeDevServerPreviewEvent, type ForgeDevServerPreviewEventListener, type ForgeDevServerPreviewOptions, type ForgeDevSession, type ForgeDevSessionDiagnostic, type ForgeDevSessionFailedEvent, type ForgeDevSessionFileChange, type ForgeDevSessionRefreshResult, type ForgeDevSessionStartedEvent, type ForgeDevSessionStartResult, type ForgeDevSessionStatus, type ForgeDevSessionStoppedEvent, type ForgeDevSessionStopResult, type ForgePreviewDocument, type ForgePreviewModuleUpdate, type ForgePreviewModuleUpdatedEvent, type ForgePreviewRefreshedEvent, type ForgePreviewStyleUpdate, type ForgePreviewStyleUpdatedEvent, type ForgeRebuildDevSessionOptions, type ForgeStartDevSessionOptions, } from "./types";

package/dist/dev-server-preview/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEV_SERVER_PREVIEW_CAPABILITY = exports.isSupportedViteDevScript = exports.DefaultDevServerPreview = exports.createDevServerPreview = exports.createForgePreviewDocument = exports.createUnsupportedDevScriptDiagnostic = exports.createSessionStoppedDiagnostic = exports.createSessionNotFoundDiagnostic = exports.createMissingDevScriptDiagnostic = void 0;
+exports.DEV_SERVER_PREVIEW_CAPABILITY = exports.isSupportedViteDevScript = exports.DefaultDevServerPreview = exports.createDevServerPreview = exports.createForgePreviewErrorOverlayDocument = exports.createForgePreviewDocument = exports.createUnsupportedDevScriptDiagnostic = exports.createSessionStoppedDiagnostic = exports.createSessionNotFoundDiagnostic = exports.createMissingDevScriptDiagnostic = void 0;
 var diagnostics_1 = require("./diagnostics");
 Object.defineProperty(exports, "createMissingDevScriptDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createMissingDevScriptDiagnostic; } });
 Object.defineProperty(exports, "createSessionNotFoundDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createSessionNotFoundDiagnostic; } });
@@ -8,6 +8,7 @@ Object.defineProperty(exports, "createSessionStoppedDiagnostic", { enumerable: t
 Object.defineProperty(exports, "createUnsupportedDevScriptDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createUnsupportedDevScriptDiagnostic; } });
 var preview_document_1 = require("./preview-document");
 Object.defineProperty(exports, "createForgePreviewDocument", { enumerable: true, get: function () { return preview_document_1.createForgePreviewDocument; } });
+Object.defineProperty(exports, "createForgePreviewErrorOverlayDocument", { enumerable: true, get: function () { return preview_document_1.createForgePreviewErrorOverlayDocument; } });
 var server_1 = require("./server");
 Object.defineProperty(exports, "createDevServerPreview", { enumerable: true, get: function () { return server_1.createDevServerPreview; } });
 Object.defineProperty(exports, "DefaultDevServerPreview", { enumerable: true, get: function () { return server_1.DefaultDevServerPreview; } });

package/dist/dev-server-preview/preview-document.d.ts

@@ -1,2 +1,3 @@
-import type { ForgeCreatePreviewDocumentOptions, ForgePreviewDocument } from "./types";
+import type { ForgeCreatePreviewDocumentOptions, ForgeDevSessionDiagnostic, ForgePreviewDocument } from "./types";
 export declare function createForgePreviewDocument(options: ForgeCreatePreviewDocumentOptions): ForgePreviewDocument;
+export declare function createForgePreviewErrorOverlayDocument(previewDocument: ForgePreviewDocument, diagnostics: readonly ForgeDevSessionDiagnostic[]): ForgePreviewDocument;

package/dist/dev-server-preview/preview-document.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createForgePreviewDocument = void 0;
+exports.createForgePreviewErrorOverlayDocument = exports.createForgePreviewDocument = void 0;
 const DEFAULT_HTML_SHELL = [
     "<!doctype html>",
     "<html>",
@@ -15,6 +15,9 @@ const DEFAULT_HTML_SHELL = [
     "</html>",
 ].join("\n");
 const PREVIEW_MODULE_SPECIFIER_PREFIX = "__forge_preview__/";
+const PREVIEW_ERROR_OVERLAY_START = "<!-- forge-preview-error-overlay:start -->";
+const PREVIEW_ERROR_OVERLAY_END = "<!-- forge-preview-error-overlay:end -->";
+const PREVIEW_RUNTIME_ERROR_CLIENT_ID = "forge-preview-runtime-error-client";
 function createForgePreviewDocument(options) {
     const htmlShell = options.htmlShell ?? DEFAULT_HTML_SHELL;
     const browserBundle = options.buildResult.browserBundle;
@@ -26,6 +29,7 @@ function createForgePreviewDocument(options) {
         : previewModuleSpecifiers.get(browserBundle.entryOutputPath) ??
             browserBundle.entryOutputPath;
     const metadata = {
+        adapter: options.adapter,
         browserBundle: browserBundle === undefined
             ? undefined
             : {
@@ -58,6 +62,7 @@ function createForgePreviewDocument(options) {
         previewImportMap === undefined
             ? ""
             : `<script type="importmap" id="forge-browser-bundle-importmap">${escapeJsonForScript(JSON.stringify(previewImportMap))}</script>`,
+        browserBundle === undefined ? "" : createPreviewRuntimeErrorClientScript(),
         browserBundle === undefined
             ? ""
             : `<script type="module" id="forge-browser-bundle-entry">import ${JSON.stringify(previewEntrySpecifier)};</script>`,
@@ -72,6 +77,16 @@ function createForgePreviewDocument(options) {
     };
 }
 exports.createForgePreviewDocument = createForgePreviewDocument;
+function createForgePreviewErrorOverlayDocument(previewDocument, diagnostics) {
+    if (diagnostics.length === 0) {
+        return previewDocument;
+    }
+    return {
+        ...previewDocument,
+        html: injectBeforeBodyEnd(removePreviewErrorOverlay(previewDocument.html), createPreviewErrorOverlay(diagnostics)),
+    };
+}
+exports.createForgePreviewErrorOverlayDocument = createForgePreviewErrorOverlayDocument;
 function createPreviewImportMap(outputFiles, previewModuleSpecifiers) {
     const importMapFile = outputFiles.find((file) => file.contentType === "application/importmap+json");
     if (importMapFile === undefined) {
@@ -130,12 +145,199 @@ function injectBeforeBodyEnd(html, injection) {
     }
     return `${html}\n${injection}`;
 }
+function createPreviewRuntimeErrorClientScript() {
+    return [
+        `<script id="${PREVIEW_RUNTIME_ERROR_CLIENT_ID}">`,
+        "(function(){",
+        '  var overlaySelector = "[data-forge-preview-runtime-error-overlay]";',
+        '  var styleSelector = "style[data-forge-preview-runtime-error-overlay-style]";',
+        "  function stringify(value){",
+        '    if (value instanceof Error) return value.message || value.name || "Runtime error";',
+        '    if (typeof value === "string") return value;',
+        "    if (value === undefined) return \"undefined\";",
+        "    if (value === null) return \"null\";",
+        "    try {",
+        "      var json = JSON.stringify(value);",
+        "      if (typeof json === \"string\") return json;",
+        "    } catch (error) {}",
+        "    return String(value);",
+        "  }",
+        "  function stackFor(value){",
+        "    return value instanceof Error && typeof value.stack === \"string\" && value.stack.length > 0",
+        "      ? value.stack",
+        "      : undefined;",
+        "  }",
+        "  function formatLocation(event){",
+        "    var parts = [];",
+        "    if (typeof event.filename === \"string\" && event.filename.length > 0) parts.push(event.filename);",
+        "    if (typeof event.lineno === \"number\" && event.lineno > 0) parts.push(\"line \" + event.lineno);",
+        "    if (typeof event.colno === \"number\" && event.colno > 0) parts.push(\"column \" + event.colno);",
+        "    return parts.length > 0 ? parts.join(\" · \") : undefined;",
+        "  }",
+        "  function createTextElement(tagName, attributeName, text){",
+        "    var element = document.createElement(tagName);",
+        "    element.setAttribute(attributeName, \"\");",
+        "    element.textContent = text;",
+        "    return element;",
+        "  }",
+        "  function ensureStyle(){",
+        "    if (document.querySelector(styleSelector)) return;",
+        "    var style = document.createElement(\"style\");",
+        "    style.setAttribute(\"data-forge-preview-runtime-error-overlay-style\", \"\");",
+        "    style.textContent = [",
+        '      "[data-forge-preview-runtime-error-overlay]{position:fixed;inset:0;z-index:2147483647;display:flex;align-items:flex-start;justify-content:center;padding:32px 16px;background:rgba(15,23,42,.72);color:#f8fafc;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,\'Segoe UI\',sans-serif;box-sizing:border-box;}",',
+        '      "[data-forge-preview-runtime-error-overlay] *{box-sizing:border-box;}",',
+        '      "[data-forge-preview-runtime-error-overlay-panel]{width:min(760px,100%);max-height:calc(100vh - 64px);overflow:auto;border:1px solid rgba(248,113,113,.45);border-radius:8px;background:#111827;box-shadow:0 24px 80px rgba(0,0,0,.42);padding:20px;}",',
+        '      "[data-forge-preview-runtime-error-overlay-kicker]{margin:0 0 6px;color:#fca5a5;font-size:12px;font-weight:700;text-transform:uppercase;letter-spacing:.08em;}",',
+        '      "[data-forge-preview-runtime-error-overlay-title]{margin:0 0 16px;font-size:20px;line-height:1.25;font-weight:700;}",',
+        '      "[data-forge-preview-runtime-error-overlay-message]{margin:0 0 12px;color:#f8fafc;font-size:14px;line-height:1.5;}",',
+        '      "[data-forge-preview-runtime-error-overlay-detail]{margin:0;color:#cbd5e1;white-space:pre-wrap;font-family:ui-monospace,SFMono-Regular,Consolas,\'Liberation Mono\',monospace;font-size:12px;line-height:1.45;}",',
+        "    ].join(\"\");",
+        "    (document.head || document.documentElement).appendChild(style);",
+        "  }",
+        "  function showOverlay(diagnostic){",
+        "    ensureStyle();",
+        "    var existing = document.querySelector(overlaySelector);",
+        "    if (existing && existing.parentNode) existing.parentNode.removeChild(existing);",
+        "    var overlay = document.createElement(\"div\");",
+        "    overlay.setAttribute(\"data-forge-preview-runtime-error-overlay\", \"\");",
+        "    overlay.setAttribute(\"role\", \"alert\");",
+        "    overlay.setAttribute(\"aria-live\", \"assertive\");",
+        "    var panel = document.createElement(\"section\");",
+        "    panel.setAttribute(\"data-forge-preview-runtime-error-overlay-panel\", \"\");",
+        "    panel.appendChild(createTextElement(\"p\", \"data-forge-preview-runtime-error-overlay-kicker\", \"Forge preview\"));",
+        "    panel.appendChild(createTextElement(\"h1\", \"data-forge-preview-runtime-error-overlay-title\", diagnostic.title));",
+        "    panel.appendChild(createTextElement(\"p\", \"data-forge-preview-runtime-error-overlay-message\", diagnostic.message));",
+        "    if (diagnostic.detail) {",
+        "      panel.appendChild(createTextElement(\"pre\", \"data-forge-preview-runtime-error-overlay-detail\", diagnostic.detail));",
+        "    }",
+        "    overlay.appendChild(panel);",
+        "    (document.body || document.documentElement).appendChild(overlay);",
+        "  }",
+        "  window.addEventListener(\"error\", function(event){",
+        "    showOverlay({",
+        "      title: \"Preview runtime error\",",
+        "      message: event.error === undefined || event.error === null",
+        "        ? event.message || \"Runtime error\"",
+        "        : stringify(event.error),",
+        "      detail: stackFor(event.error) || formatLocation(event),",
+        "    });",
+        "    event.preventDefault();",
+        "  });",
+        "  window.addEventListener(\"unhandledrejection\", function(event){",
+        "    showOverlay({",
+        "      title: \"Unhandled promise rejection\",",
+        "      message: stringify(event.reason),",
+        "      detail: stackFor(event.reason),",
+        "    });",
+        "    event.preventDefault();",
+        "  });",
+        "})();",
+        "</script>",
+    ].join("\n");
+}
+function createPreviewErrorOverlay(diagnostics) {
+    const items = diagnostics.map(createPreviewErrorOverlayItem).join("\n");
+    return [
+        PREVIEW_ERROR_OVERLAY_START,
+        '<style data-forge-preview-error-overlay>',
+        "[data-forge-preview-error-overlay]{position:fixed;inset:0;z-index:2147483647;display:flex;align-items:flex-start;justify-content:center;padding:32px 16px;background:rgba(15,23,42,.72);color:#f8fafc;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;box-sizing:border-box;}",
+        "[data-forge-preview-error-overlay] *{box-sizing:border-box;}",
+        "[data-forge-preview-error-overlay-panel]{width:min(760px,100%);max-height:calc(100vh - 64px);overflow:auto;border:1px solid rgba(248,113,113,.45);border-radius:8px;background:#111827;box-shadow:0 24px 80px rgba(0,0,0,.42);padding:20px;}",
+        "[data-forge-preview-error-overlay-kicker]{margin:0 0 6px;color:#fca5a5;font-size:12px;font-weight:700;text-transform:uppercase;letter-spacing:.08em;}",
+        "[data-forge-preview-error-overlay-title]{margin:0 0 16px;font-size:20px;line-height:1.25;font-weight:700;}",
+        "[data-forge-preview-error-overlay-list]{display:grid;gap:12px;margin:0;padding:0;list-style:none;}",
+        "[data-forge-preview-error-overlay-item]{display:grid;gap:6px;border-top:1px solid rgba(148,163,184,.22);padding-top:12px;}",
+        "[data-forge-preview-error-overlay-code]{width:max-content;border-radius:4px;background:rgba(248,113,113,.16);color:#fecaca;padding:2px 6px;font-family:ui-monospace,SFMono-Regular,Consolas,'Liberation Mono',monospace;font-size:12px;}",
+        "[data-forge-preview-error-overlay-message]{margin:0;color:#f8fafc;font-size:14px;line-height:1.5;}",
+        "[data-forge-preview-error-overlay-detail]{margin:0;color:#cbd5e1;font-family:ui-monospace,SFMono-Regular,Consolas,'Liberation Mono',monospace;font-size:12px;line-height:1.45;}",
+        "</style>",
+        '<div data-forge-preview-error-overlay role="alert" aria-live="assertive">',
+        '  <section data-forge-preview-error-overlay-panel>',
+        '    <p data-forge-preview-error-overlay-kicker>Forge preview</p>',
+        '    <h1 data-forge-preview-error-overlay-title>Preview refresh failed</h1>',
+        `    <ul data-forge-preview-error-overlay-list>${items}</ul>`,
+        "  </section>",
+        "</div>",
+        PREVIEW_ERROR_OVERLAY_END,
+    ].join("\n");
+}
+function createPreviewErrorOverlayItem(diagnostic) {
+    const detail = formatDiagnosticDetail(diagnostic);
+    return [
+        "      <li data-forge-preview-error-overlay-item>",
+        `        <code data-forge-preview-error-overlay-code>${escapeHtml(diagnostic.code)}</code>`,
+        `        <p data-forge-preview-error-overlay-message>${escapeHtml(diagnostic.message)}</p>`,
+        detail === undefined
+            ? ""
+            : `        <p data-forge-preview-error-overlay-detail>${escapeHtml(detail)}</p>`,
+        "      </li>",
+    ]
+        .filter((line) => line.length > 0)
+        .join("\n");
+}
+function formatDiagnosticDetail(diagnostic) {
+    const parts = [
+        getStringDiagnosticProperty(diagnostic, "path"),
+        getStringDiagnosticProperty(diagnostic, "importer"),
+        getStringDiagnosticProperty(diagnostic, "importSpecifier"),
+        getStringDiagnosticProperty(diagnostic, "dependencyName"),
+        getStringDiagnosticProperty(diagnostic, "requestedRange"),
+        getStringDiagnosticProperty(diagnostic, "script"),
+        getStringDiagnosticProperty(diagnostic, "sessionId"),
+        formatLimitDiagnostic(diagnostic),
+    ].filter((part) => part !== undefined && part.length > 0);
+    return parts.length === 0 ? undefined : parts.join(" · ");
+}
+function getStringDiagnosticProperty(diagnostic, key) {
+    const value = diagnostic[key];
+    return typeof value === "string" ? value : undefined;
+}
+function formatLimitDiagnostic(diagnostic) {
+    const limit = diagnostic.limit;
+    if (typeof limit !== "object" || limit === null) {
+        return undefined;
+    }
+    const name = limit.name;
+    const actual = limit.actual;
+    const maximum = limit.maximum;
+    if (typeof name !== "string" ||
+        typeof actual !== "number" ||
+        typeof maximum !== "number") {
+        return undefined;
+    }
+    return `${name}: ${actual}/${maximum}`;
+}
+function removePreviewErrorOverlay(html) {
+    return html.replace(new RegExp(`${escapeRegExp(PREVIEW_ERROR_OVERLAY_START)}[\\s\\S]*?${escapeRegExp(PREVIEW_ERROR_OVERLAY_END)}\\n?`, "g"), "");
+}
 function removeProjectModuleScripts(html) {
     return html.replace(/<script\b(?=[^>]*\btype\s*=\s*["']module["'])[^>]*>[\s\S]*?<\/script\s*>/gi, "");
 }
 function escapeJsonForScript(json) {
     return json.replace(/</g, "\\u003c");
 }
+function escapeHtml(value) {
+    return value.replace(/[&<>"']/g, (character) => {
+        switch (character) {
+            case "&":
+                return "&amp;";
+            case "<":
+                return "&lt;";
+            case ">":
+                return "&gt;";
+            case '"':
+                return "&quot;";
+            case "'":
+                return "&#39;";
+            default:
+                return character;
+        }
+    });
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function toBase64(bytes) {
     const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
     let output = "";

package/dist/dev-server-preview/server.d.ts

@@ -14,10 +14,17 @@ export declare class DefaultDevServerPreview implements ForgeDevServerPreview {
     stop(sessionId: string): Promise<ForgeDevSessionStopResult>;
     getSession(sessionId: string): ForgeDevSession | undefined;
     watch(listener: ForgeDevServerPreviewEventListener): ForgeUnsubscribe;
-    private validateDevScript;
+    private readDevManifest;
     private failStart;
     private handleFileEvent;
+    private handleWorkspaceChange;
+    private wasCssPathBundled;
+    private wasWorkspaceModuleBundled;
+    private performStyleUpdate;
+    private performModuleUpdate;
     private performRebuild;
+    private completeSuccessfulRefresh;
+    private completeFailedRebuild;
     private createPreviewDocument;
     private allocateSessionId;
     private emit;