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

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

@@ -34,10 +34,15 @@ class DefaultDevServerPreview {
             },
         };
         this.sessions.set(sessionId, record);
-        const devScriptDiagnostics = await this.validateDevScript();
-        if (devScriptDiagnostics.length > 0) {
-            return this.failStart(record, devScriptDiagnostics, "dev-script");
+        const devManifestResult = await this.readDevManifest();
+        if (!devManifestResult.success) {
+            return this.failStart(record, devManifestResult.diagnostics, "dev-script");
         }
+        record.adapter = selectDevServerAdapter(devManifestResult.manifest);
+        record.session = {
+            ...record.session,
+            adapter: record.adapter,
+        };
         const buildResult = await this.options.buildPipeline.build({
             entry: options.entry,
             signal: options.signal,
@@ -45,15 +50,19 @@ class DefaultDevServerPreview {
         if (!buildResult.success) {
             return this.failStart(record, buildResult.diagnostics, "initial-build", buildResult);
         }
-        const previewDocument = await this.createPreviewDocument(sessionId, previewUrl, 1, buildResult);
+        const previewDocument = await this.createPreviewDocument(sessionId, previewUrl, 1, buildResult, record.adapter);
+        record.lastSuccessfulBuildResult = buildResult;
+        record.lastSuccessfulPreviewDocument = previewDocument;
         const session = {
             ...record.session,
             status: "running",
+            adapter: record.adapter,
             revision: 1,
             updatedAt: this.now(),
             diagnostics: buildResult.diagnostics,
             buildResult,
             previewDocument,
+            errorOverlayDocument: undefined,
         };
         record.session = session;
         record.unsubscribe = this.options.fileSystem.watch((event) => {
@@ -88,6 +97,7 @@ class DefaultDevServerPreview {
             status: "stopped",
             updatedAt: this.now(),
             diagnostics: [],
+            errorOverlayDocument: undefined,
         };
         record.session = session;
         this.emit({ type: "dev:session-stopped", session });
@@ -106,21 +116,34 @@ class DefaultDevServerPreview {
             this.listeners.delete(listener);
         };
     }
-    async validateDevScript() {
+    async readDevManifest() {
         try {
             const manifest = await (0, package_resolution_1.readPackageManifest)(this.options.fileSystem);
             const devScript = manifest.scripts.dev;
             if (devScript === undefined) {
-                return [(0, diagnostics_1.createMissingDevScriptDiagnostic)()];
+                return {
+                    success: false,
+                    diagnostics: [(0, diagnostics_1.createMissingDevScriptDiagnostic)()],
+                };
             }
             if (!isSupportedViteDevScript(devScript)) {
-                return [(0, diagnostics_1.createUnsupportedDevScriptDiagnostic)(devScript)];
+                return {
+                    success: false,
+                    diagnostics: [(0, diagnostics_1.createUnsupportedDevScriptDiagnostic)(devScript)],
+                };
             }
-            return [];
+            return {
+                success: true,
+                diagnostics: [],
+                manifest,
+            };
         }
         catch (error) {
             if (error instanceof package_resolution_1.ForgePackageResolutionError) {
-                return [error.diagnostic];
+                return {
+                    success: false,
+                    diagnostics: [error.diagnostic],
+                };
             }
             throw error;
         }
@@ -154,13 +177,59 @@ class DefaultDevServerPreview {
             return;
         }
         const previous = record.rebuildQueue ?? Promise.resolve(undefined);
-        const next = previous.then(() => this.performRebuild(record, change.reason, record.entry));
+        const next = previous.then(() => this.handleWorkspaceChange(record, event, change.reason));
         record.rebuildQueue = next;
         void next.catch(() => {
             record.rebuildQueue = undefined;
         });
     }
-    async performRebuild(record, reason, entry, signal) {
+    async handleWorkspaceChange(record, event, reason) {
+        const cssPath = getUpdatedCssPath(event);
+        if (cssPath !== undefined &&
+            record.session.status === "running" &&
+            this.wasCssPathBundled(record, cssPath)) {
+            await this.performStyleUpdate(record, cssPath, reason);
+            return;
+        }
+        const scriptPath = getUpdatedScriptModulePath(event);
+        if (scriptPath !== undefined &&
+            record.session.status === "running" &&
+            this.wasWorkspaceModuleBundled(record, scriptPath)) {
+            return this.performModuleUpdate(record, scriptPath, reason);
+        }
+        return this.performRebuild(record, reason, record.entry);
+    }
+    wasCssPathBundled(record, path) {
+        const styleId = createForgeCssStyleId(path);
+        return (record.lastSuccessfulBuildResult?.outputFiles.some((file) => file.contentType === "text/javascript" &&
+            file.content.includes(styleId)) ?? false);
+    }
+    wasWorkspaceModuleBundled(record, path) {
+        return (record.lastSuccessfulBuildResult?.browserBundle?.modules.some((moduleRecord) => moduleRecord.origin === "workspace" &&
+            moduleRecord.sourcePath === path) ?? false);
+    }
+    async performStyleUpdate(record, sourcePath, reason) {
+        const content = await this.options.fileSystem.readText(sourcePath);
+        const session = {
+            ...record.session,
+            status: "running",
+            updatedAt: this.now(),
+            errorOverlayDocument: undefined,
+        };
+        record.session = session;
+        this.emit({
+            type: "preview:style-updated",
+            session,
+            styleUpdate: {
+                content,
+                contentType: "text/css",
+                sourcePath,
+                styleId: createForgeCssStyleId(sourcePath),
+            },
+            reason,
+        });
+    }
+    async performModuleUpdate(record, sourcePath, reason) {
         if (record.session.status === "stopped") {
             const diagnostic = (0, diagnostics_1.createSessionStoppedDiagnostic)(record.session.id);
             return {
@@ -169,37 +238,74 @@ class DefaultDevServerPreview {
                 diagnostics: [diagnostic],
             };
         }
+        const previousBuildResult = record.lastSuccessfulBuildResult;
         record.session = {
             ...record.session,
             status: "rebuilding",
             updatedAt: this.now(),
+            errorOverlayDocument: undefined,
         };
-        const buildResult = await this.options.buildPipeline.build({ entry, signal });
+        const buildResult = await this.options.buildPipeline.build({
+            entry: record.entry,
+        });
         if (!buildResult.success) {
-            const session = {
-                ...record.session,
-                status: "failed",
-                updatedAt: this.now(),
-                diagnostics: buildResult.diagnostics,
-                buildResult,
-            };
-            record.session = session;
-            this.emit({
-                type: "dev:session-failed",
-                session,
-                diagnostics: buildResult.diagnostics,
-                buildResult,
-                reason,
-            });
+            return this.completeFailedRebuild(record, reason, buildResult);
+        }
+        const moduleUpdate = createModuleUpdate(previousBuildResult, buildResult, sourcePath);
+        if (moduleUpdate === undefined) {
+            return this.completeSuccessfulRefresh(record, reason, buildResult);
+        }
+        record.lastSuccessfulBuildResult = buildResult;
+        const session = {
+            ...record.session,
+            status: "running",
+            updatedAt: this.now(),
+            diagnostics: buildResult.diagnostics,
+            buildResult,
+            previewDocument: record.lastSuccessfulPreviewDocument ?? record.session.previewDocument,
+            errorOverlayDocument: undefined,
+        };
+        record.session = session;
+        this.emit({
+            type: "preview:module-updated",
+            session,
+            moduleUpdate,
+            buildResult,
+            reason,
+        });
+        return {
+            success: true,
+            session,
+            diagnostics: buildResult.diagnostics,
+            buildResult,
+        };
+    }
+    async performRebuild(record, reason, entry, signal) {
+        if (record.session.status === "stopped") {
+            const diagnostic = (0, diagnostics_1.createSessionStoppedDiagnostic)(record.session.id);
             return {
                 success: false,
-                session,
-                diagnostics: buildResult.diagnostics,
-                buildResult,
+                session: record.session,
+                diagnostics: [diagnostic],
             };
         }
+        record.session = {
+            ...record.session,
+            status: "rebuilding",
+            updatedAt: this.now(),
+            errorOverlayDocument: undefined,
+        };
+        const buildResult = await this.options.buildPipeline.build({ entry, signal });
+        if (!buildResult.success) {
+            return this.completeFailedRebuild(record, reason, buildResult);
+        }
+        return this.completeSuccessfulRefresh(record, reason, buildResult);
+    }
+    async completeSuccessfulRefresh(record, reason, buildResult) {
         const revision = record.session.revision + 1;
-        const previewDocument = await this.createPreviewDocument(record.session.id, record.session.previewUrl, revision, buildResult);
+        const previewDocument = await this.createPreviewDocument(record.session.id, record.session.previewUrl, revision, buildResult, record.adapter);
+        record.lastSuccessfulBuildResult = buildResult;
+        record.lastSuccessfulPreviewDocument = previewDocument;
         const session = {
             ...record.session,
             status: "running",
@@ -208,6 +314,7 @@ class DefaultDevServerPreview {
             diagnostics: buildResult.diagnostics,
             buildResult,
             previewDocument,
+            errorOverlayDocument: undefined,
         };
         record.session = session;
         this.emit({
@@ -223,11 +330,41 @@ class DefaultDevServerPreview {
             buildResult,
         };
     }
-    async createPreviewDocument(sessionId, previewUrl, revision, buildResult) {
+    completeFailedRebuild(record, reason, buildResult) {
+        const previousPreviewDocument = record.lastSuccessfulPreviewDocument ?? record.session.previewDocument;
+        const errorOverlayDocument = previousPreviewDocument === undefined
+            ? undefined
+            : (0, preview_document_1.createForgePreviewErrorOverlayDocument)(previousPreviewDocument, buildResult.diagnostics);
+        const session = {
+            ...record.session,
+            status: "failed",
+            updatedAt: this.now(),
+            diagnostics: buildResult.diagnostics,
+            buildResult,
+            previewDocument: previousPreviewDocument,
+            errorOverlayDocument,
+        };
+        record.session = session;
+        this.emit({
+            type: "dev:session-failed",
+            session,
+            diagnostics: buildResult.diagnostics,
+            buildResult,
+            reason,
+        });
+        return {
+            success: false,
+            session,
+            diagnostics: buildResult.diagnostics,
+            buildResult,
+        };
+    }
+    async createPreviewDocument(sessionId, previewUrl, revision, buildResult, adapter) {
         const htmlShell = (await this.options.fileSystem.exists("/index.html"))
             ? await this.options.fileSystem.readText("/index.html")
             : undefined;
         return (0, preview_document_1.createForgePreviewDocument)({
+            adapter,
             buildResult,
             htmlShell,
             previewUrl,
@@ -269,6 +406,30 @@ exports.isSupportedViteDevScript = isSupportedViteDevScript;
 function createPreviewUrl(sessionId) {
     return `/preview/${encodeURIComponent(sessionId)}/`;
 }
+function selectDevServerAdapter(manifest) {
+    const dependencies = {
+        ...manifest.dependencies,
+        ...manifest.devDependencies,
+    };
+    if ("react" in dependencies || "react-dom" in dependencies) {
+        return createDevServerAdapterMetadata("vite-react", "react");
+    }
+    if ("vue" in dependencies) {
+        return createDevServerAdapterMetadata("vite-vue", "vue");
+    }
+    return createDevServerAdapterMetadata("vite-vanilla", "vanilla");
+}
+function createDevServerAdapterMetadata(name, framework) {
+    return {
+        framework,
+        hmrMode: "hmr-lite",
+        name,
+        preservesState: false,
+    };
+}
+function createForgeCssStyleId(path) {
+    return `forge-css:${path}`;
+}
 function describeFileChange(event) {
     const path = event.type === "file:renamed" ? event.to : event.path;
     if (path.startsWith("/.forge/")) {
@@ -278,3 +439,56 @@ function describeFileChange(event) {
         reason: `${event.type}:${path}`,
     };
 }
+function getUpdatedCssPath(event) {
+    return event.type === "file:updated" &&
+        event.path.endsWith(".css") &&
+        !event.path.endsWith(".module.css")
+        ? event.path
+        : undefined;
+}
+function getUpdatedScriptModulePath(event) {
+    return event.type === "file:updated" && isHmrScriptPath(event.path)
+        ? event.path
+        : undefined;
+}
+function createModuleUpdate(previousBuildResult, buildResult, sourcePath) {
+    const previousBundle = previousBuildResult?.browserBundle;
+    const nextBundle = buildResult.browserBundle;
+    if (previousBundle === undefined ||
+        nextBundle === undefined ||
+        previousBundle.entry === sourcePath ||
+        nextBundle.entry === sourcePath ||
+        !sameOutputPaths(previousBundle.outputPaths, nextBundle.outputPaths)) {
+        return undefined;
+    }
+    const previousModule = findWorkspaceModule(previousBundle.modules, sourcePath);
+    const nextModule = findWorkspaceModule(nextBundle.modules, sourcePath);
+    if (previousModule === undefined ||
+        nextModule === undefined ||
+        previousModule.outputPath !== nextModule.outputPath) {
+        return undefined;
+    }
+    const outputFile = buildResult.outputFiles.find((file) => file.path === nextModule.outputPath &&
+        file.contentType === "text/javascript");
+    return outputFile === undefined
+        ? undefined
+        : {
+            content: outputFile.content,
+            contentType: "text/javascript",
+            outputPath: nextModule.outputPath,
+            sourcePath,
+        };
+}
+function findWorkspaceModule(modules, sourcePath) {
+    return modules.find((moduleRecord) => moduleRecord.origin === "workspace" &&
+        moduleRecord.sourcePath === sourcePath);
+}
+function sameOutputPaths(left, right) {
+    const sortedLeft = [...left].sort();
+    const sortedRight = [...right].sort();
+    return (sortedLeft.length === sortedRight.length &&
+        sortedLeft.every((path, index) => path === sortedRight[index]));
+}
+function isHmrScriptPath(path) {
+    return /\.(?:jsx?|tsx?)$/i.test(path);
+}

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

@@ -4,6 +4,15 @@ import type { ForgeFileEvent, ForgeUnsubscribe, ForgeVirtualFileSystem } from ".
 export declare const DEV_SERVER_PREVIEW_CAPABILITY: "dev-server-preview";
 export type ForgeDevSessionStatus = "starting" | "running" | "rebuilding" | "stopped" | "failed";
 export type ForgeDevServerPreviewDiagnosticCode = "missing_dev_script" | "session_not_found" | "session_stopped" | "unsupported_dev_script";
+export type ForgeDevServerAdapterName = "vite-react" | "vite-vanilla" | "vite-vue";
+export type ForgeDevServerAdapterFramework = "react" | "vanilla" | "vue";
+export type ForgeDevServerAdapterHmrMode = "hmr-lite";
+export interface ForgeDevServerAdapterMetadata {
+    readonly framework: ForgeDevServerAdapterFramework;
+    readonly hmrMode: ForgeDevServerAdapterHmrMode;
+    readonly name: ForgeDevServerAdapterName;
+    readonly preservesState: false;
+}
 export interface ForgeDevServerPreviewDiagnostic {
     readonly code: ForgeDevServerPreviewDiagnosticCode;
     readonly severity: "error";
@@ -19,7 +28,20 @@ export interface ForgePreviewDocument {
     readonly revision: number;
     readonly sessionId: string;
 }
+export interface ForgePreviewStyleUpdate {
+    readonly content: string;
+    readonly contentType: "text/css";
+    readonly sourcePath: string;
+    readonly styleId: string;
+}
+export interface ForgePreviewModuleUpdate {
+    readonly content: string;
+    readonly contentType: "text/javascript";
+    readonly outputPath: string;
+    readonly sourcePath: string;
+}
 export interface ForgeDevSession {
+    readonly adapter?: ForgeDevServerAdapterMetadata;
     readonly id: string;
     readonly status: ForgeDevSessionStatus;
     readonly previewUrl: string;
@@ -29,6 +51,7 @@ export interface ForgeDevSession {
     readonly diagnostics: readonly ForgeDevSessionDiagnostic[];
     readonly buildResult?: ForgeBuildResult;
     readonly previewDocument?: ForgePreviewDocument;
+    readonly errorOverlayDocument?: ForgePreviewDocument;
 }
 export interface ForgeStartDevSessionOptions {
     readonly entry?: string;
@@ -57,7 +80,7 @@ export interface ForgeDevSessionStopResult {
     readonly session?: ForgeDevSession;
     readonly diagnostics: readonly ForgeDevSessionDiagnostic[];
 }
-export type ForgeDevServerPreviewEvent = ForgeDevSessionFailedEvent | ForgeDevSessionStartedEvent | ForgeDevSessionStoppedEvent | ForgePreviewRefreshedEvent;
+export type ForgeDevServerPreviewEvent = ForgeDevSessionFailedEvent | ForgePreviewModuleUpdatedEvent | ForgeDevSessionStartedEvent | ForgeDevSessionStoppedEvent | ForgePreviewStyleUpdatedEvent | ForgePreviewRefreshedEvent;
 export interface ForgeDevSessionStartedEvent {
     readonly type: "dev:session-started";
     readonly session: ForgeDevSession;
@@ -72,6 +95,19 @@ export interface ForgePreviewRefreshedEvent {
     readonly buildResult: ForgeBuildResult;
     readonly reason: string;
 }
+export interface ForgePreviewStyleUpdatedEvent {
+    readonly type: "preview:style-updated";
+    readonly session: ForgeDevSession;
+    readonly styleUpdate: ForgePreviewStyleUpdate;
+    readonly reason: string;
+}
+export interface ForgePreviewModuleUpdatedEvent {
+    readonly type: "preview:module-updated";
+    readonly session: ForgeDevSession;
+    readonly moduleUpdate: ForgePreviewModuleUpdate;
+    readonly buildResult: ForgeBuildResult;
+    readonly reason: string;
+}
 export interface ForgeDevSessionFailedEvent {
     readonly type: "dev:session-failed";
     readonly session: ForgeDevSession;
@@ -87,6 +123,7 @@ export interface ForgeDevServerPreviewOptions {
     readonly now?: () => string;
 }
 export interface ForgeCreatePreviewDocumentOptions {
+    readonly adapter?: ForgeDevServerAdapterMetadata;
     readonly buildResult: ForgeBuildResult;
     readonly htmlShell?: string;
     readonly previewUrl: string;

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { createEsbuildWasmWorkerMessageHandler, createEsbuildWasmWorkerService, createTransformFailureDiagnostic, createUnsupportedOperationDiagnostic, createWasmInitializationFailureDiagnostic, createWorkerNotInitializedDiagnostic, createWorkerStartupFailureDiagnostic, DefaultEsbuildWasmWorkerService, ESBUILD_WASM_WORKER_CAPABILITY, ESBUILD_WASM_WORKER_PROTOCOL, installEsbuildWasmWorker, type ForgeEsbuildWasmDiagnosticCauseCategory, type ForgeEsbuildWasmInitializeFailureResult, type ForgeEsbuildWasmInitializeRequest, type ForgeEsbuildWasmInitializeResult, type ForgeEsbuildWasmInitializeSuccessResult, type ForgeEsbuildWasmInitializeWorkerFailureResponse, type ForgeEsbuildWasmInitializeWorkerRequest, type ForgeEsbuildWasmInitializeWorkerSuccessResponse, type ForgeEsbuildWasmRuntime, type ForgeEsbuildWasmRuntimeMetadata, type ForgeEsbuildWasmTransformFailureResult, type ForgeEsbuildWasmTransformLoader, type ForgeEsbuildWasmTransformRequest, type ForgeEsbuildWasmTransformResult, type ForgeEsbuildWasmTransformSuccessResult, type ForgeEsbuildWasmTransformWarning, type ForgeEsbuildWasmTransformWorkerFailureResponse, type ForgeEsbuildWasmTransformWorkerRequest, type ForgeEsbuildWasmTransformWorkerSuccessResponse, type ForgeEsbuildWasmUnsupportedOperation, type ForgeEsbuildWasmUnsupportedOperationResult, type ForgeEsbuildWasmUrl, type ForgeEsbuildWasmWorkerAdapterOptions, type ForgeEsbuildWasmWorkerDiagnostic, type ForgeEsbuildWasmWorkerDiagnosticCode, type ForgeEsbuildWasmWorkerFactory, type ForgeEsbuildWasmWorkerGlobalScope, type ForgeEsbuildWasmWorkerMessageEvent, type ForgeEsbuildWasmWorkerPort, type ForgeEsbuildWasmWorkerRequestMessage, type ForgeEsbuildWasmWorkerResponseMessage, type ForgeEsbuildWasmWorkerService, type ForgeEsbuildWasmWorkerServiceOptions, } from "./esbuild-wasm-worker";
 export { createForgeController, openForgeController, type ForgeController, type ForgeControllerOptions, type ForgeOpenControllerOptions, } from "./forge-controller";
-export { BUILD_PIPELINE_CAPABILITY, createBuildCancelledDiagnostic, createBuildPipeline, createEsbuildWorkerTransformDiagnostic, createMissingBuildScriptDiagnostic, createMissingEntryDiagnostic, createUnresolvedImportDiagnostic, createUnsupportedBuildScriptDiagnostic, createViteConfigNotExecutedDiagnostic, DefaultBuildPipeline, isSupportedViteBuildScript, type ForgeBrowserBundle, type ForgeBrowserBundleManifest, type ForgeBuildDiagnostic, type ForgeBuildManifest, type ForgeBuildMode, type ForgeBuildOutputFile, type ForgeBuildPipeline, type ForgeBuildPipelineDiagnostic, type ForgeBuildPipelineDiagnosticCode, type ForgeBuildPipelineOptions, type ForgeBuildRequest, type ForgeBuildResult, type ForgeBuildTiming, } from "./build-pipeline";
+export { BUILD_PIPELINE_CAPABILITY, createBuildCancelledDiagnostic, createBuildPipeline, createEsbuildWorkerTransformDiagnostic, createMissingBuildScriptDiagnostic, createMissingEntryDiagnostic, createUnresolvedImportDiagnostic, createUnsupportedBuildScriptDiagnostic, createViteConfigNotExecutedDiagnostic, DefaultBuildPipeline, isSupportedViteBuildScript, type ForgeBrowserBundle, type ForgeBrowserBundleManifest, type ForgeBrowserBundleModule, type ForgeBrowserBundleModuleOrigin, type ForgeBuildDiagnostic, type ForgeBuildManifest, type ForgeBuildMode, type ForgeBuildOutputFile, type ForgeBuildPipeline, type ForgeBuildPipelineDiagnostic, type ForgeBuildPipelineDiagnosticCode, type ForgeBuildPipelineOptions, type ForgeBuildRequest, type ForgeBuildResult, type ForgeBuildTiming, } from "./build-pipeline";
 export { createInvalidDependencyDiagnostic, createInvalidManifestDiagnostic, createCdnPackageSource, createOfflineCacheMissDiagnostic, createPackageCacheKey, createPackageResolutionDiagnostic, createPackageResolver, createUnsupportedRangeDiagnostic, createUnresolvedPackageDiagnostic, collectDependencyRequests, DEFAULT_FORGE_MANIFEST_PATH, DefaultPackageResolver, ForgePackageResolutionError, PACKAGE_RESOLUTION_CAPABILITY, readPackageManifest, type ForgeBundleAliases, type ForgeCdnPackageFetch, type ForgeCdnPackageMetadataUrlFactory, type ForgeCdnPackageSourceOptions, type ForgeDependencyKind, type ForgeDependencyRequest, type ForgeImportMap, type ForgePackageCacheMode, type ForgePackageDiagnostic, type ForgePackageFile, type ForgePackageLockMetadata, type ForgePackageLockPackage, type ForgePackageManifest, type ForgePackageRecord, type ForgePackageResolutionDiagnostic, type ForgePackageResolutionDiagnosticCode, type ForgePackageResolutionMode, type ForgePackageResolutionResult, type ForgePackageResolver, type ForgePackageResolverOptions, type ForgePackageSource, type ForgeResolvePackagesOptions, } from "./package-resolution";
-export { createDevServerPreview, createForgePreviewDocument, createMissingDevScriptDiagnostic, createSessionNotFoundDiagnostic, createSessionStoppedDiagnostic, createUnsupportedDevScriptDiagnostic, DefaultDevServerPreview, DEV_SERVER_PREVIEW_CAPABILITY, isSupportedViteDevScript, 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 "./dev-server-preview";
+export { createDevServerPreview, createForgePreviewDocument, createForgePreviewErrorOverlayDocument, createMissingDevScriptDiagnostic, createSessionNotFoundDiagnostic, createSessionStoppedDiagnostic, createUnsupportedDevScriptDiagnostic, DefaultDevServerPreview, DEV_SERVER_PREVIEW_CAPABILITY, isSupportedViteDevScript, 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 "./dev-server-preview";
 export { createForgeTerminal, createNpmInstallCommandHandler, createNpmRunBuildCommandHandler, createNpmRunDevCommandHandler, createParseErrorDiagnostic, createUnsupportedCommandDiagnostic, DefaultForgeTerminal, NpmInstallCommandHandler, NpmRunBuildCommandHandler, NpmRunDevCommandHandler, parseForgeCommandText, TERMINAL_COMMANDS_CAPABILITY, type ForgeCommand, type ForgeCommandContext, type ForgeCommandDiagnostic, type ForgeCommandHandler, type ForgeCommandParseResult, type ForgeCommandResult, type ForgeTerminal, type ForgeTerminalDiagnostic, type ForgeTerminalDiagnosticCode, type ForgeTerminalExecuteOptions, type ForgeTerminalOptions, type ForgeTerminalOutputKind, type ForgeTerminalOutputLine, } from "./terminal-commands";
 export { completeForgeTelemetryTiming, createForgeUnsupportedPackageReason, emitForgeTelemetry, startForgeTelemetryTiming, summarizeForgeTelemetryDiagnostics, TELEMETRY_CAPABILITY, type ForgeBuildTelemetryEvent, type ForgePackageResolutionTelemetryEvent, type ForgeTelemetryDiagnosticLike, type ForgeTelemetryDiagnosticSummary, type ForgeTelemetryEvent, type ForgeTelemetryOperation, type ForgeTelemetryOutcome, type ForgeTelemetryReporter, type ForgeTelemetryTiming, type ForgeTelemetryTimingStart, type ForgeUnsupportedPackageReason, } from "./telemetry";
 export { createVirtualFileSystem, createForgeDiagnostic, createInvalidPathDiagnostic, createInvalidSnapshotDiagnostic, createMissingParentDiagnostic, createNotFoundDiagnostic, createNotImplementedDiagnostic, createPathTraversalDiagnostic, createIndexedDbForgeStorage, createLimitExceededDiagnostic, exportWorkspaceSnapshot, ForgeFileSystemError, DEFAULT_FORGE_VFS_LIMITS, FORGE_INDEXED_DB_NAME, FORGE_INDEXED_DB_STORES, FORGE_INDEXED_DB_VERSION, FORGE_WORKSPACE_SNAPSHOT_EXPORT_SCHEMA_VERSION, IndexedDbForgeStorage, importWorkspaceSnapshot, normalizeForgePath, openVirtualFileSystem, resolveForgeVirtualFileSystemLimits, VIRTUAL_FILE_SYSTEM_CAPABILITY, type ForgeBuildCacheRecord, type ForgeDiagnosticInput, type ForgeDeleteOptions, type ForgeDiagnostic, type ForgeDiagnosticCode, type ForgeDiagnosticSeverity, type ForgeDirEntry, type ForgeFileCreatedEvent, type ForgeFileDeletedEvent, type ForgeFileEvent, type ForgeFileKind, type ForgeFileRecord, type ForgeFileRenamedEvent, type ForgeFileSource, type ForgeFileStat, type ForgeFileUpdatedEvent, type ForgeFileWatchListener, type ForgeLimitDiagnostic, type ForgeMkdirOptions, type ForgeOpenVirtualFileSystemOptions, type ForgePackageCacheRecord, type ForgePersistedWorkspace, type ForgeSerializedFileRecord, type ForgeSerializedWorkspaceSnapshot, type ForgeSerializedWorkspaceSnapshotPayload, type ForgeVirtualFileSystemLimits, type ResolvedForgeVirtualFileSystemLimits, type ForgeRestoreOptions, type ForgeSnapshot, type ForgeSnapshotOptions, type ForgeUnsubscribe, type ForgeVirtualFileSystemOptions, type ForgeVirtualFileSystemStorage, type ForgeVirtualFileSystem, type ForgeWorkspace, type ForgeWorkspaceMetadata, type ForgeWorkspaceSnapshotExportOptions, type ForgeWriteFileOptions, type ForgePathNormalizationResult, type IndexedDbForgeStorageOptions, } from "./virtual-file-system";

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createNpmInstallCommandHandler = exports.createForgeTerminal = exports.isSupportedViteDevScript = exports.DEV_SERVER_PREVIEW_CAPABILITY = exports.DefaultDevServerPreview = exports.createUnsupportedDevScriptDiagnostic = exports.createSessionStoppedDiagnostic = exports.createSessionNotFoundDiagnostic = exports.createMissingDevScriptDiagnostic = exports.createForgePreviewDocument = exports.createDevServerPreview = exports.readPackageManifest = exports.PACKAGE_RESOLUTION_CAPABILITY = exports.ForgePackageResolutionError = exports.DefaultPackageResolver = exports.DEFAULT_FORGE_MANIFEST_PATH = exports.collectDependencyRequests = exports.createUnresolvedPackageDiagnostic = exports.createUnsupportedRangeDiagnostic = exports.createPackageResolver = exports.createPackageResolutionDiagnostic = exports.createPackageCacheKey = exports.createOfflineCacheMissDiagnostic = exports.createCdnPackageSource = exports.createInvalidManifestDiagnostic = exports.createInvalidDependencyDiagnostic = exports.isSupportedViteBuildScript = exports.DefaultBuildPipeline = exports.createViteConfigNotExecutedDiagnostic = exports.createUnsupportedBuildScriptDiagnostic = exports.createUnresolvedImportDiagnostic = exports.createMissingEntryDiagnostic = exports.createMissingBuildScriptDiagnostic = exports.createEsbuildWorkerTransformDiagnostic = exports.createBuildPipeline = exports.createBuildCancelledDiagnostic = exports.BUILD_PIPELINE_CAPABILITY = exports.openForgeController = exports.createForgeController = exports.installEsbuildWasmWorker = exports.ESBUILD_WASM_WORKER_PROTOCOL = exports.ESBUILD_WASM_WORKER_CAPABILITY = exports.DefaultEsbuildWasmWorkerService = exports.createWorkerStartupFailureDiagnostic = exports.createWorkerNotInitializedDiagnostic = exports.createWasmInitializationFailureDiagnostic = exports.createUnsupportedOperationDiagnostic = exports.createTransformFailureDiagnostic = exports.createEsbuildWasmWorkerService = exports.createEsbuildWasmWorkerMessageHandler = void 0;
-exports.VIRTUAL_FILE_SYSTEM_CAPABILITY = exports.resolveForgeVirtualFileSystemLimits = exports.openVirtualFileSystem = exports.normalizeForgePath = exports.importWorkspaceSnapshot = exports.IndexedDbForgeStorage = exports.FORGE_WORKSPACE_SNAPSHOT_EXPORT_SCHEMA_VERSION = exports.FORGE_INDEXED_DB_VERSION = exports.FORGE_INDEXED_DB_STORES = exports.FORGE_INDEXED_DB_NAME = exports.DEFAULT_FORGE_VFS_LIMITS = exports.ForgeFileSystemError = exports.exportWorkspaceSnapshot = exports.createLimitExceededDiagnostic = exports.createIndexedDbForgeStorage = exports.createPathTraversalDiagnostic = exports.createNotImplementedDiagnostic = exports.createNotFoundDiagnostic = exports.createMissingParentDiagnostic = exports.createInvalidSnapshotDiagnostic = exports.createInvalidPathDiagnostic = exports.createForgeDiagnostic = exports.createVirtualFileSystem = exports.TELEMETRY_CAPABILITY = exports.summarizeForgeTelemetryDiagnostics = exports.startForgeTelemetryTiming = exports.emitForgeTelemetry = exports.createForgeUnsupportedPackageReason = exports.completeForgeTelemetryTiming = exports.TERMINAL_COMMANDS_CAPABILITY = exports.parseForgeCommandText = exports.NpmRunDevCommandHandler = exports.NpmRunBuildCommandHandler = exports.NpmInstallCommandHandler = exports.DefaultForgeTerminal = exports.createUnsupportedCommandDiagnostic = exports.createParseErrorDiagnostic = exports.createNpmRunDevCommandHandler = exports.createNpmRunBuildCommandHandler = void 0;
+exports.createForgeTerminal = exports.isSupportedViteDevScript = exports.DEV_SERVER_PREVIEW_CAPABILITY = exports.DefaultDevServerPreview = exports.createUnsupportedDevScriptDiagnostic = exports.createSessionStoppedDiagnostic = exports.createSessionNotFoundDiagnostic = exports.createMissingDevScriptDiagnostic = exports.createForgePreviewErrorOverlayDocument = exports.createForgePreviewDocument = exports.createDevServerPreview = exports.readPackageManifest = exports.PACKAGE_RESOLUTION_CAPABILITY = exports.ForgePackageResolutionError = exports.DefaultPackageResolver = exports.DEFAULT_FORGE_MANIFEST_PATH = exports.collectDependencyRequests = exports.createUnresolvedPackageDiagnostic = exports.createUnsupportedRangeDiagnostic = exports.createPackageResolver = exports.createPackageResolutionDiagnostic = exports.createPackageCacheKey = exports.createOfflineCacheMissDiagnostic = exports.createCdnPackageSource = exports.createInvalidManifestDiagnostic = exports.createInvalidDependencyDiagnostic = exports.isSupportedViteBuildScript = exports.DefaultBuildPipeline = exports.createViteConfigNotExecutedDiagnostic = exports.createUnsupportedBuildScriptDiagnostic = exports.createUnresolvedImportDiagnostic = exports.createMissingEntryDiagnostic = exports.createMissingBuildScriptDiagnostic = exports.createEsbuildWorkerTransformDiagnostic = exports.createBuildPipeline = exports.createBuildCancelledDiagnostic = exports.BUILD_PIPELINE_CAPABILITY = exports.openForgeController = exports.createForgeController = exports.installEsbuildWasmWorker = exports.ESBUILD_WASM_WORKER_PROTOCOL = exports.ESBUILD_WASM_WORKER_CAPABILITY = exports.DefaultEsbuildWasmWorkerService = exports.createWorkerStartupFailureDiagnostic = exports.createWorkerNotInitializedDiagnostic = exports.createWasmInitializationFailureDiagnostic = exports.createUnsupportedOperationDiagnostic = exports.createTransformFailureDiagnostic = exports.createEsbuildWasmWorkerService = exports.createEsbuildWasmWorkerMessageHandler = void 0;
+exports.VIRTUAL_FILE_SYSTEM_CAPABILITY = exports.resolveForgeVirtualFileSystemLimits = exports.openVirtualFileSystem = exports.normalizeForgePath = exports.importWorkspaceSnapshot = exports.IndexedDbForgeStorage = exports.FORGE_WORKSPACE_SNAPSHOT_EXPORT_SCHEMA_VERSION = exports.FORGE_INDEXED_DB_VERSION = exports.FORGE_INDEXED_DB_STORES = exports.FORGE_INDEXED_DB_NAME = exports.DEFAULT_FORGE_VFS_LIMITS = exports.ForgeFileSystemError = exports.exportWorkspaceSnapshot = exports.createLimitExceededDiagnostic = exports.createIndexedDbForgeStorage = exports.createPathTraversalDiagnostic = exports.createNotImplementedDiagnostic = exports.createNotFoundDiagnostic = exports.createMissingParentDiagnostic = exports.createInvalidSnapshotDiagnostic = exports.createInvalidPathDiagnostic = exports.createForgeDiagnostic = exports.createVirtualFileSystem = exports.TELEMETRY_CAPABILITY = exports.summarizeForgeTelemetryDiagnostics = exports.startForgeTelemetryTiming = exports.emitForgeTelemetry = exports.createForgeUnsupportedPackageReason = exports.completeForgeTelemetryTiming = exports.TERMINAL_COMMANDS_CAPABILITY = exports.parseForgeCommandText = exports.NpmRunDevCommandHandler = exports.NpmRunBuildCommandHandler = exports.NpmInstallCommandHandler = exports.DefaultForgeTerminal = exports.createUnsupportedCommandDiagnostic = exports.createParseErrorDiagnostic = exports.createNpmRunDevCommandHandler = exports.createNpmRunBuildCommandHandler = exports.createNpmInstallCommandHandler = void 0;
 var esbuild_wasm_worker_1 = require("./esbuild-wasm-worker");
 Object.defineProperty(exports, "createEsbuildWasmWorkerMessageHandler", { enumerable: true, get: function () { return esbuild_wasm_worker_1.createEsbuildWasmWorkerMessageHandler; } });
 Object.defineProperty(exports, "createEsbuildWasmWorkerService", { enumerable: true, get: function () { return esbuild_wasm_worker_1.createEsbuildWasmWorkerService; } });
@@ -48,6 +48,7 @@ Object.defineProperty(exports, "readPackageManifest", { enumerable: true, get: f
 var dev_server_preview_1 = require("./dev-server-preview");
 Object.defineProperty(exports, "createDevServerPreview", { enumerable: true, get: function () { return dev_server_preview_1.createDevServerPreview; } });
 Object.defineProperty(exports, "createForgePreviewDocument", { enumerable: true, get: function () { return dev_server_preview_1.createForgePreviewDocument; } });
+Object.defineProperty(exports, "createForgePreviewErrorOverlayDocument", { enumerable: true, get: function () { return dev_server_preview_1.createForgePreviewErrorOverlayDocument; } });
 Object.defineProperty(exports, "createMissingDevScriptDiagnostic", { enumerable: true, get: function () { return dev_server_preview_1.createMissingDevScriptDiagnostic; } });
 Object.defineProperty(exports, "createSessionNotFoundDiagnostic", { enumerable: true, get: function () { return dev_server_preview_1.createSessionNotFoundDiagnostic; } });
 Object.defineProperty(exports, "createSessionStoppedDiagnostic", { enumerable: true, get: function () { return dev_server_preview_1.createSessionStoppedDiagnostic; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caryhu/codemine-forge",
-  "version": "0.0.1-alpha.1",
+  "version": "0.0.1-alpha.3",
   "description": "Browser-side runtime layer for Codemine demos.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,6 +18,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@vue/compiler-sfc": "3.4.0",
     "esbuild-wasm": "^0.28.1",
     "typescript": "4.9.5"
   },
@@ -34,7 +35,7 @@
     "publish:npm": "node scripts/publish-npm.mjs",
     "typecheck": "tsc -p tsconfig.json",
     "test:build": "tsc -p tsconfig.test.json",
-    "test": "pnpm run test:build && node test/virtual-file-system.test.mjs && node test/indexeddb-workspace-restore.test.mjs && node test/react-vite-template-dev-loop.test.mjs && node test/react-vite-template-diagnostics.test.mjs && node test/package-resolution.test.mjs && node test/build-pipeline.test.mjs && node test/dev-server-preview.test.mjs && node test/terminal-commands.test.mjs && node test/esbuild-wasm-worker.test.mjs && node test/browser-preview-execution.test.mjs && node test/demo-samples.test.mjs",
+    "test": "pnpm run test:build && node test/virtual-file-system.test.mjs && node test/indexeddb-workspace-restore.test.mjs && node test/react-vite-template-dev-loop.test.mjs && node test/react-vite-template-diagnostics.test.mjs && node test/vue-vite-template-dev-loop.test.mjs && node test/package-resolution.test.mjs && node test/build-pipeline.test.mjs && node test/dev-server-preview.test.mjs && node test/terminal-commands.test.mjs && node test/esbuild-wasm-worker.test.mjs && node test/browser-preview-execution.test.mjs && node test/demo-samples.test.mjs",
     "test:browser-preview": "pnpm run test:build && node test/browser-preview-execution.test.mjs",
     "test:demo-samples": "pnpm run test:build && node test/demo-samples.test.mjs",
     "test:static-demo": "node test/static-demo.test.mjs",