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

package/README.md

@@ -71,18 +71,22 @@ Publish prerelease builds to npm with:
 pnpm run publish:npm
 ```
 
-The script validates the package, checks that the current version is not already
-published, runs a package dry run, and publishes with the `alpha` dist-tag by
-default. If npm login is required, it starts the npm web login flow in the
-browser and waits for authentication to complete.
+The script updates the package version, validates the package, checks that the
+target version is not already published, runs a package dry run, and publishes
+with the `alpha` dist-tag by default. In `auto` mode, it keeps the current
+version when it has not been published yet and bumps to the next available
+prerelease version when it has. If npm login is required, it starts the npm web
+login flow in the browser and waits for authentication to complete.
 
 Useful options:
 
 ```powershell
 pnpm run publish:npm -- --dry-run
+pnpm run publish:npm -- --bump prerelease
 pnpm run publish:npm -- --tag next
 pnpm run publish:npm -- --login-only
 pnpm run publish:npm -- --otp 123456
+pnpm run publish:npm -- --version 0.0.2-alpha.0
 ```
 
 ## Design Principles

package/dist/build-pipeline/diagnostics.d.ts

@@ -1,5 +1,6 @@
 import type { ForgeBuildPipelineDiagnostic } from "./types";
 export declare function createEsbuildWorkerTransformDiagnostic(path: string, cause: unknown): ForgeBuildPipelineDiagnostic;
+export declare function createBuildCancelledDiagnostic(cause?: unknown): ForgeBuildPipelineDiagnostic;
 export declare function createMissingBuildScriptDiagnostic(): ForgeBuildPipelineDiagnostic;
 export declare function createUnsupportedBuildScriptDiagnostic(script: string): ForgeBuildPipelineDiagnostic;
 export declare function createMissingEntryDiagnostic(): ForgeBuildPipelineDiagnostic;

package/dist/build-pipeline/diagnostics.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createViteConfigNotExecutedDiagnostic = exports.createUnresolvedImportDiagnostic = exports.createMissingEntryDiagnostic = exports.createUnsupportedBuildScriptDiagnostic = exports.createMissingBuildScriptDiagnostic = exports.createEsbuildWorkerTransformDiagnostic = void 0;
+exports.createViteConfigNotExecutedDiagnostic = exports.createUnresolvedImportDiagnostic = exports.createMissingEntryDiagnostic = exports.createUnsupportedBuildScriptDiagnostic = exports.createMissingBuildScriptDiagnostic = exports.createBuildCancelledDiagnostic = exports.createEsbuildWorkerTransformDiagnostic = void 0;
 function createEsbuildWorkerTransformDiagnostic(path, cause) {
     return {
         code: "esbuild_worker_transform_failed",
@@ -12,6 +12,15 @@ function createEsbuildWorkerTransformDiagnostic(path, cause) {
     };
 }
 exports.createEsbuildWorkerTransformDiagnostic = createEsbuildWorkerTransformDiagnostic;
+function createBuildCancelledDiagnostic(cause) {
+    return {
+        code: "build_cancelled",
+        severity: "error",
+        message: "Forge build was cancelled.",
+        cause,
+    };
+}
+exports.createBuildCancelledDiagnostic = createBuildCancelledDiagnostic;
 function createMissingBuildScriptDiagnostic() {
     return {
         code: "missing_build_script",

package/dist/build-pipeline/index.d.ts

@@ -1,3 +1,3 @@
-export { createEsbuildWorkerTransformDiagnostic, createMissingBuildScriptDiagnostic, createMissingEntryDiagnostic, createUnresolvedImportDiagnostic, createUnsupportedBuildScriptDiagnostic, createViteConfigNotExecutedDiagnostic, } from "./diagnostics";
+export { createBuildCancelledDiagnostic, createEsbuildWorkerTransformDiagnostic, createMissingBuildScriptDiagnostic, createMissingEntryDiagnostic, createUnresolvedImportDiagnostic, createUnsupportedBuildScriptDiagnostic, createViteConfigNotExecutedDiagnostic, } from "./diagnostics";
 export { createBuildPipeline, DefaultBuildPipeline, isSupportedViteBuildScript, } from "./pipeline";
 export { BUILD_PIPELINE_CAPABILITY, 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 "./types";

package/dist/build-pipeline/index.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BUILD_PIPELINE_CAPABILITY = exports.isSupportedViteBuildScript = exports.DefaultBuildPipeline = exports.createBuildPipeline = exports.createViteConfigNotExecutedDiagnostic = exports.createUnsupportedBuildScriptDiagnostic = exports.createUnresolvedImportDiagnostic = exports.createMissingEntryDiagnostic = exports.createMissingBuildScriptDiagnostic = exports.createEsbuildWorkerTransformDiagnostic = void 0;
+exports.BUILD_PIPELINE_CAPABILITY = exports.isSupportedViteBuildScript = exports.DefaultBuildPipeline = exports.createBuildPipeline = exports.createViteConfigNotExecutedDiagnostic = exports.createUnsupportedBuildScriptDiagnostic = exports.createUnresolvedImportDiagnostic = exports.createMissingEntryDiagnostic = exports.createMissingBuildScriptDiagnostic = exports.createEsbuildWorkerTransformDiagnostic = exports.createBuildCancelledDiagnostic = void 0;
 var diagnostics_1 = require("./diagnostics");
+Object.defineProperty(exports, "createBuildCancelledDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createBuildCancelledDiagnostic; } });
 Object.defineProperty(exports, "createEsbuildWorkerTransformDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createEsbuildWorkerTransformDiagnostic; } });
 Object.defineProperty(exports, "createMissingBuildScriptDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createMissingBuildScriptDiagnostic; } });
 Object.defineProperty(exports, "createMissingEntryDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createMissingEntryDiagnostic; } });

package/dist/build-pipeline/pipeline.d.ts

@@ -7,6 +7,8 @@ export declare class DefaultBuildPipeline implements ForgeBuildPipeline {
     build(request?: ForgeBuildRequest): Promise<ForgeBuildResult>;
     private resolveEntry;
     private failure;
+    private complete;
+    private writeBuildCacheRecord;
 }
 export declare function createBuildPipeline(options: ForgeBuildPipelineOptions): ForgeBuildPipeline;
 export declare function isSupportedViteBuildScript(script: string): boolean;

package/dist/build-pipeline/pipeline.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isSupportedViteBuildScript = exports.createBuildPipeline = exports.DefaultBuildPipeline = void 0;
 const package_resolution_1 = require("../package-resolution");
+const telemetry_1 = require("../telemetry");
 const virtual_file_system_1 = require("../virtual-file-system");
 const diagnostics_1 = require("./diagnostics");
 const browser_bundle_1 = require("./browser-bundle");
@@ -27,14 +28,22 @@ class DefaultBuildPipeline {
     async build(request = {}) {
         const timingStart = createTimingStart(this.now());
         const mode = "production";
+        const initialCancellation = getCancellationDiagnostic(request.signal);
+        if (initialCancellation !== undefined) {
+            return this.failure(mode, [initialCancellation], timingStart);
+        }
         const warningDiagnostics = await detectViteConfigDiagnostics(this.options.fileSystem);
+        const configCancellation = getCancellationDiagnostic(request.signal);
+        if (configCancellation !== undefined) {
+            return this.failure(mode, [configCancellation, ...warningDiagnostics], timingStart);
+        }
         let manifest;
         try {
             manifest = await (0, package_resolution_1.readPackageManifest)(this.options.fileSystem);
         }
         catch (error) {
             if (error instanceof package_resolution_1.ForgePackageResolutionError) {
-                return this.failure(mode, [error.diagnostic, ...warningDiagnostics], timingStart);
+                return this.failure(mode, [error.diagnostic, ...error.warnings, ...warningDiagnostics], timingStart);
             }
             throw error;
         }
@@ -48,12 +57,21 @@ class DefaultBuildPipeline {
                 ...warningDiagnostics,
             ], timingStart);
         }
+        const manifestCancellation = getCancellationDiagnostic(request.signal);
+        if (manifestCancellation !== undefined) {
+            return this.failure(mode, [manifestCancellation, ...warningDiagnostics], timingStart);
+        }
         const entry = await this.resolveEntry(request.entry);
         if (entry === undefined) {
             return this.failure(mode, [(0, diagnostics_1.createMissingEntryDiagnostic)(), ...warningDiagnostics], timingStart);
         }
         try {
             const packageResolution = await this.options.packageResolver.resolve();
+            const packageWarnings = packageResolution.warnings;
+            const packageCancellation = getCancellationDiagnostic(request.signal);
+            if (packageCancellation !== undefined) {
+                return this.failure(mode, [packageCancellation, ...packageWarnings, ...warningDiagnostics], timingStart);
+            }
             const sourceFiles = await collectSourceFiles(this.options.fileSystem);
             const browserBundleResult = await (0, browser_bundle_1.createBrowserBundle)({
                 entry,
@@ -62,29 +80,56 @@ class DefaultBuildPipeline {
                 scriptTransformer: createEsbuildWorkerScriptTransformer(this.options.esbuildWorker),
             });
             if (browserBundleResult.diagnostics.length > 0) {
-                return this.failure(mode, [...browserBundleResult.diagnostics, ...warningDiagnostics], timingStart);
+                return this.failure(mode, [
+                    ...browserBundleResult.diagnostics,
+                    ...packageWarnings,
+                    ...warningDiagnostics,
+                ], timingStart);
+            }
+            if (browserBundleResult.browserBundle === undefined) {
+                throw new Error("Browser bundle output was missing after a successful build.");
+            }
+            const bundleCancellation = getCancellationDiagnostic(request.signal);
+            if (bundleCancellation !== undefined) {
+                return this.failure(mode, [bundleCancellation, ...packageWarnings, ...warningDiagnostics], timingStart);
             }
             const buildManifest = createBuildManifest(entry, mode, sourceFiles, packageResolution, browserBundleResult.browserBundle);
             const outputFiles = [
                 createBuildManifestOutput(buildManifest),
                 ...browserBundleResult.outputFiles,
             ];
-            await writeBuildOutputFiles(this.options.fileSystem, outputFiles);
-            return {
+            const outputCancellation = getCancellationDiagnostic(request.signal);
+            if (outputCancellation !== undefined) {
+                return this.failure(mode, [outputCancellation, ...packageWarnings, ...warningDiagnostics], timingStart);
+            }
+            const outputWriteDiagnostic = await writeBuildOutputFilesAtomically(this.options.fileSystem, outputFiles);
+            if (outputWriteDiagnostic !== undefined) {
+                return this.failure(mode, [outputWriteDiagnostic, ...packageWarnings, ...warningDiagnostics], timingStart);
+            }
+            const buildCacheWarnings = await this.writeBuildCacheRecord(entry, mode, buildManifest, browserBundleResult.browserBundle, outputFiles);
+            const cacheCancellation = getCancellationDiagnostic(request.signal);
+            if (cacheCancellation !== undefined) {
+                return this.failure(mode, [cacheCancellation, ...packageWarnings, ...buildCacheWarnings, ...warningDiagnostics], timingStart);
+            }
+            return this.complete({
                 success: true,
                 mode,
                 entry,
                 browserBundle: browserBundleResult.browserBundle,
                 manifest: buildManifest,
                 outputFiles,
-                diagnostics: warningDiagnostics,
+                diagnostics: [
+                    ...packageWarnings,
+                    ...buildCacheWarnings,
+                    ...warningDiagnostics,
+                ],
                 packageResolution,
                 timing: completeTiming(timingStart, this.now()),
-            };
+            });
         }
         catch (error) {
             if (error instanceof package_resolution_1.ForgePackageResolutionError) {
-                return this.failure(mode, [error.diagnostic, ...warningDiagnostics], timingStart);
+                return this.failure(mode, [error.diagnostic, ...error.warnings, ...warningDiagnostics], timingStart);
             }
             throw error;
         }
@@ -109,16 +154,68 @@ class DefaultBuildPipeline {
         return undefined;
     }
     failure(mode, diagnostics, timingStart) {
-        return {
+        return this.complete({
             success: false,
             mode,
             outputFiles: [],
             diagnostics,
             timing: completeTiming(timingStart, this.now()),
+        });
+    }
+    complete(result) {
+        (0, telemetry_1.emitForgeTelemetry)(this.options.telemetry, {
+            operation: "build",
+            outcome: result.success ? "success" : "failure",
+            startedAt: result.timing.startedAt,
+            endedAt: result.timing.endedAt,
+            durationMs: result.timing.durationMs,
+            mode: result.mode,
+            entry: result.entry,
+            outputFileCount: result.outputFiles.length,
+            packageCount: result.packageResolution?.packages.length,
+            diagnostics: (0, telemetry_1.summarizeForgeTelemetryDiagnostics)(result.diagnostics),
+        });
+        return result;
+    }
+    async writeBuildCacheRecord(entry, mode, manifest, browserBundle, outputFiles) {
+        if (this.options.storage === undefined) {
+            return [];
+        }
+        const value = {
+            browserBundle,
+            entry,
+            manifest,
+            mode,
+            outputFiles: outputFiles.map((outputFile) => ({
+                contentType: outputFile.contentType,
+                path: outputFile.path,
+                size: outputFile.size,
+            })),
         };
+        const encoded = new TextEncoder().encode(JSON.stringify(value));
+        try {
+            await this.options.storage.putBuildCacheRecord({
+                key: `build:${mode}:${entry}`,
+                size: encoded.byteLength,
+                updatedAt: this.now(),
+                value,
+            });
+            return [];
+        }
+        catch (error) {
+            if (isLimitExceededError(error)) {
+                return [toWarningDiagnostic(error.diagnostic)];
+            }
+            throw error;
+        }
     }
 }
 exports.DefaultBuildPipeline = DefaultBuildPipeline;
+function getCancellationDiagnostic(signal) {
+    return signal?.aborted === true
+        ? (0, diagnostics_1.createBuildCancelledDiagnostic)(signal.reason)
+        : undefined;
+}
 function createEsbuildWorkerScriptTransformer(esbuildWorker) {
     if (esbuildWorker === undefined) {
         return undefined;
@@ -248,6 +345,22 @@ async function writeBuildOutputFiles(fileSystem, outputFiles) {
         });
     }
 }
+async function writeBuildOutputFilesAtomically(fileSystem, outputFiles) {
+    const rollbackSnapshot = await fileSystem.snapshot({
+        includeGeneratedFiles: true,
+    });
+    try {
+        await writeBuildOutputFiles(fileSystem, outputFiles);
+        return undefined;
+    }
+    catch (error) {
+        if (isLimitExceededError(error)) {
+            await fileSystem.restore(rollbackSnapshot);
+            return error.diagnostic;
+        }
+        throw error;
+    }
+}
 async function ensureDirectory(fileSystem, path) {
     await fileSystem.mkdir(path, {
         recursive: true,
@@ -271,3 +384,13 @@ function completeTiming(start, endedAt) {
         durationMs: Math.max(0, Date.now() - start.startedMs),
     };
 }
+function isLimitExceededError(error) {
+    return (error instanceof virtual_file_system_1.ForgeFileSystemError &&
+        error.diagnostic.code === "limit_exceeded");
+}
+function toWarningDiagnostic(diagnostic) {
+    return {
+        ...diagnostic,
+        severity: "warning",
+    };
+}

package/dist/build-pipeline/types.d.ts

@@ -1,9 +1,10 @@
 import type { ForgeImportMap, ForgePackageDiagnostic, ForgePackageResolutionResult, ForgePackageResolver } from "../package-resolution";
 import type { ForgeEsbuildWasmWorkerDiagnostic, ForgeEsbuildWasmWorkerService } from "../esbuild-wasm-worker";
-import type { ForgeVirtualFileSystem } from "../virtual-file-system";
+import type { ForgeVirtualFileSystem, ForgeVirtualFileSystemStorage } from "../virtual-file-system";
+import type { ForgeTelemetryReporter } from "../telemetry";
 export declare const BUILD_PIPELINE_CAPABILITY: "build-pipeline";
 export type ForgeBuildMode = "production";
-export type ForgeBuildPipelineDiagnosticCode = "esbuild_worker_transform_failed" | "missing_build_script" | "missing_entry" | "unresolved_import" | "unsupported_build_script" | "vite_config_not_executed";
+export type ForgeBuildPipelineDiagnosticCode = "build_cancelled" | "esbuild_worker_transform_failed" | "missing_build_script" | "missing_entry" | "unresolved_import" | "unsupported_build_script" | "vite_config_not_executed";
 export interface ForgeBuildPipelineDiagnostic {
     readonly code: ForgeBuildPipelineDiagnosticCode;
     readonly severity: "error" | "warning";
@@ -66,10 +67,13 @@ export interface ForgeBuildPipelineOptions {
     readonly fileSystem: ForgeVirtualFileSystem;
     readonly packageResolver: ForgePackageResolver;
     readonly esbuildWorker?: ForgeEsbuildWasmWorkerService;
+    readonly telemetry?: ForgeTelemetryReporter;
     readonly now?: () => string;
+    readonly storage?: ForgeVirtualFileSystemStorage;
 }
 export interface ForgeBuildRequest {
     readonly entry?: string;
+    readonly signal?: AbortSignal;
 }
 export interface ForgeBuildPipeline {
     readonly capability: typeof BUILD_PIPELINE_CAPABILITY;

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

@@ -40,6 +40,7 @@ class DefaultDevServerPreview {
         }
         const buildResult = await this.options.buildPipeline.build({
             entry: options.entry,
+            signal: options.signal,
         });
         if (!buildResult.success) {
             return this.failStart(record, buildResult.diagnostics, "initial-build", buildResult);
@@ -72,7 +73,7 @@ class DefaultDevServerPreview {
             const diagnostic = (0, diagnostics_1.createSessionNotFoundDiagnostic)(sessionId);
             return { success: false, diagnostics: [diagnostic] };
         }
-        return this.performRebuild(record, options.reason ?? "manual", options.entry);
+        return this.performRebuild(record, options.reason ?? "manual", options.entry, options.signal);
     }
     async stop(sessionId) {
         const record = this.sessions.get(sessionId);
@@ -159,7 +160,7 @@ class DefaultDevServerPreview {
             record.rebuildQueue = undefined;
         });
     }
-    async performRebuild(record, reason, entry) {
+    async performRebuild(record, reason, entry, signal) {
         if (record.session.status === "stopped") {
             const diagnostic = (0, diagnostics_1.createSessionStoppedDiagnostic)(record.session.id);
             return {
@@ -173,7 +174,7 @@ class DefaultDevServerPreview {
             status: "rebuilding",
             updatedAt: this.now(),
         };
-        const buildResult = await this.options.buildPipeline.build({ entry });
+        const buildResult = await this.options.buildPipeline.build({ entry, signal });
         if (!buildResult.success) {
             const session = {
                 ...record.session,

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

@@ -33,10 +33,12 @@ export interface ForgeDevSession {
 export interface ForgeStartDevSessionOptions {
     readonly entry?: string;
     readonly sessionId?: string;
+    readonly signal?: AbortSignal;
 }
 export interface ForgeRebuildDevSessionOptions {
     readonly entry?: string;
     readonly reason?: string;
+    readonly signal?: AbortSignal;
 }
 export interface ForgeDevSessionStartResult {
     readonly success: boolean;

package/dist/forge-controller.js

@@ -48,6 +48,7 @@ async function openForgeController(options) {
     const buildPipeline = (0, build_pipeline_1.createBuildPipeline)({
         fileSystem,
         packageResolver,
+        storage,
     });
     const devServerPreview = (0, dev_server_preview_1.createDevServerPreview)({
         fileSystem,

package/dist/index.d.ts

@@ -1,7 +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, 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 { createInvalidDependencyDiagnostic, createInvalidManifestDiagnostic, createCdnPackageSource, 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 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 { 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 { 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 { 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 { createVirtualFileSystem, createForgeDiagnostic, createInvalidPathDiagnostic, createMissingParentDiagnostic, createNotFoundDiagnostic, createNotImplementedDiagnostic, createPathTraversalDiagnostic, createIndexedDbForgeStorage, createLimitExceededDiagnostic, ForgeFileSystemError, DEFAULT_FORGE_VFS_LIMITS, FORGE_INDEXED_DB_NAME, FORGE_INDEXED_DB_STORES, FORGE_INDEXED_DB_VERSION, IndexedDbForgeStorage, 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 ForgeVirtualFileSystemLimits, type ResolvedForgeVirtualFileSystemLimits, type ForgeRestoreOptions, type ForgeSnapshot, type ForgeSnapshotOptions, type ForgeUnsubscribe, type ForgeVirtualFileSystemOptions, type ForgeVirtualFileSystemStorage, type ForgeVirtualFileSystem, type ForgeWorkspace, type ForgeWorkspaceMetadata, type ForgeWriteFileOptions, type ForgePathNormalizationResult, type IndexedDbForgeStorageOptions, } from "./virtual-file-system";
+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.createNpmRunDevCommandHandler = exports.createNpmRunBuildCommandHandler = 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.createCdnPackageSource = exports.createInvalidManifestDiagnostic = exports.createInvalidDependencyDiagnostic = exports.isSupportedViteBuildScript = exports.DefaultBuildPipeline = exports.createViteConfigNotExecutedDiagnostic = exports.createUnsupportedBuildScriptDiagnostic = exports.createUnresolvedImportDiagnostic = exports.createMissingEntryDiagnostic = exports.createMissingBuildScriptDiagnostic = exports.createEsbuildWorkerTransformDiagnostic = exports.createBuildPipeline = 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.IndexedDbForgeStorage = exports.FORGE_INDEXED_DB_VERSION = exports.FORGE_INDEXED_DB_STORES = exports.FORGE_INDEXED_DB_NAME = exports.DEFAULT_FORGE_VFS_LIMITS = exports.ForgeFileSystemError = exports.createLimitExceededDiagnostic = exports.createIndexedDbForgeStorage = exports.createPathTraversalDiagnostic = exports.createNotImplementedDiagnostic = exports.createNotFoundDiagnostic = exports.createMissingParentDiagnostic = exports.createInvalidPathDiagnostic = exports.createForgeDiagnostic = exports.createVirtualFileSystem = exports.TERMINAL_COMMANDS_CAPABILITY = exports.parseForgeCommandText = exports.NpmRunDevCommandHandler = exports.NpmRunBuildCommandHandler = exports.NpmInstallCommandHandler = exports.DefaultForgeTerminal = exports.createUnsupportedCommandDiagnostic = exports.createParseErrorDiagnostic = void 0;
+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;
 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; } });
@@ -19,6 +19,7 @@ Object.defineProperty(exports, "createForgeController", { enumerable: true, get:
 Object.defineProperty(exports, "openForgeController", { enumerable: true, get: function () { return forge_controller_1.openForgeController; } });
 var build_pipeline_1 = require("./build-pipeline");
 Object.defineProperty(exports, "BUILD_PIPELINE_CAPABILITY", { enumerable: true, get: function () { return build_pipeline_1.BUILD_PIPELINE_CAPABILITY; } });
+Object.defineProperty(exports, "createBuildCancelledDiagnostic", { enumerable: true, get: function () { return build_pipeline_1.createBuildCancelledDiagnostic; } });
 Object.defineProperty(exports, "createBuildPipeline", { enumerable: true, get: function () { return build_pipeline_1.createBuildPipeline; } });
 Object.defineProperty(exports, "createEsbuildWorkerTransformDiagnostic", { enumerable: true, get: function () { return build_pipeline_1.createEsbuildWorkerTransformDiagnostic; } });
 Object.defineProperty(exports, "createMissingBuildScriptDiagnostic", { enumerable: true, get: function () { return build_pipeline_1.createMissingBuildScriptDiagnostic; } });
@@ -32,6 +33,7 @@ var package_resolution_1 = require("./package-resolution");
 Object.defineProperty(exports, "createInvalidDependencyDiagnostic", { enumerable: true, get: function () { return package_resolution_1.createInvalidDependencyDiagnostic; } });
 Object.defineProperty(exports, "createInvalidManifestDiagnostic", { enumerable: true, get: function () { return package_resolution_1.createInvalidManifestDiagnostic; } });
 Object.defineProperty(exports, "createCdnPackageSource", { enumerable: true, get: function () { return package_resolution_1.createCdnPackageSource; } });
+Object.defineProperty(exports, "createOfflineCacheMissDiagnostic", { enumerable: true, get: function () { return package_resolution_1.createOfflineCacheMissDiagnostic; } });
 Object.defineProperty(exports, "createPackageCacheKey", { enumerable: true, get: function () { return package_resolution_1.createPackageCacheKey; } });
 Object.defineProperty(exports, "createPackageResolutionDiagnostic", { enumerable: true, get: function () { return package_resolution_1.createPackageResolutionDiagnostic; } });
 Object.defineProperty(exports, "createPackageResolver", { enumerable: true, get: function () { return package_resolution_1.createPackageResolver; } });
@@ -66,22 +68,33 @@ Object.defineProperty(exports, "NpmRunBuildCommandHandler", { enumerable: true,
 Object.defineProperty(exports, "NpmRunDevCommandHandler", { enumerable: true, get: function () { return terminal_commands_1.NpmRunDevCommandHandler; } });
 Object.defineProperty(exports, "parseForgeCommandText", { enumerable: true, get: function () { return terminal_commands_1.parseForgeCommandText; } });
 Object.defineProperty(exports, "TERMINAL_COMMANDS_CAPABILITY", { enumerable: true, get: function () { return terminal_commands_1.TERMINAL_COMMANDS_CAPABILITY; } });
+var telemetry_1 = require("./telemetry");
+Object.defineProperty(exports, "completeForgeTelemetryTiming", { enumerable: true, get: function () { return telemetry_1.completeForgeTelemetryTiming; } });
+Object.defineProperty(exports, "createForgeUnsupportedPackageReason", { enumerable: true, get: function () { return telemetry_1.createForgeUnsupportedPackageReason; } });
+Object.defineProperty(exports, "emitForgeTelemetry", { enumerable: true, get: function () { return telemetry_1.emitForgeTelemetry; } });
+Object.defineProperty(exports, "startForgeTelemetryTiming", { enumerable: true, get: function () { return telemetry_1.startForgeTelemetryTiming; } });
+Object.defineProperty(exports, "summarizeForgeTelemetryDiagnostics", { enumerable: true, get: function () { return telemetry_1.summarizeForgeTelemetryDiagnostics; } });
+Object.defineProperty(exports, "TELEMETRY_CAPABILITY", { enumerable: true, get: function () { return telemetry_1.TELEMETRY_CAPABILITY; } });
 var virtual_file_system_1 = require("./virtual-file-system");
 Object.defineProperty(exports, "createVirtualFileSystem", { enumerable: true, get: function () { return virtual_file_system_1.createVirtualFileSystem; } });
 Object.defineProperty(exports, "createForgeDiagnostic", { enumerable: true, get: function () { return virtual_file_system_1.createForgeDiagnostic; } });
 Object.defineProperty(exports, "createInvalidPathDiagnostic", { enumerable: true, get: function () { return virtual_file_system_1.createInvalidPathDiagnostic; } });
+Object.defineProperty(exports, "createInvalidSnapshotDiagnostic", { enumerable: true, get: function () { return virtual_file_system_1.createInvalidSnapshotDiagnostic; } });
 Object.defineProperty(exports, "createMissingParentDiagnostic", { enumerable: true, get: function () { return virtual_file_system_1.createMissingParentDiagnostic; } });
 Object.defineProperty(exports, "createNotFoundDiagnostic", { enumerable: true, get: function () { return virtual_file_system_1.createNotFoundDiagnostic; } });
 Object.defineProperty(exports, "createNotImplementedDiagnostic", { enumerable: true, get: function () { return virtual_file_system_1.createNotImplementedDiagnostic; } });
 Object.defineProperty(exports, "createPathTraversalDiagnostic", { enumerable: true, get: function () { return virtual_file_system_1.createPathTraversalDiagnostic; } });
 Object.defineProperty(exports, "createIndexedDbForgeStorage", { enumerable: true, get: function () { return virtual_file_system_1.createIndexedDbForgeStorage; } });
 Object.defineProperty(exports, "createLimitExceededDiagnostic", { enumerable: true, get: function () { return virtual_file_system_1.createLimitExceededDiagnostic; } });
+Object.defineProperty(exports, "exportWorkspaceSnapshot", { enumerable: true, get: function () { return virtual_file_system_1.exportWorkspaceSnapshot; } });
 Object.defineProperty(exports, "ForgeFileSystemError", { enumerable: true, get: function () { return virtual_file_system_1.ForgeFileSystemError; } });
 Object.defineProperty(exports, "DEFAULT_FORGE_VFS_LIMITS", { enumerable: true, get: function () { return virtual_file_system_1.DEFAULT_FORGE_VFS_LIMITS; } });
 Object.defineProperty(exports, "FORGE_INDEXED_DB_NAME", { enumerable: true, get: function () { return virtual_file_system_1.FORGE_INDEXED_DB_NAME; } });
 Object.defineProperty(exports, "FORGE_INDEXED_DB_STORES", { enumerable: true, get: function () { return virtual_file_system_1.FORGE_INDEXED_DB_STORES; } });
 Object.defineProperty(exports, "FORGE_INDEXED_DB_VERSION", { enumerable: true, get: function () { return virtual_file_system_1.FORGE_INDEXED_DB_VERSION; } });
+Object.defineProperty(exports, "FORGE_WORKSPACE_SNAPSHOT_EXPORT_SCHEMA_VERSION", { enumerable: true, get: function () { return virtual_file_system_1.FORGE_WORKSPACE_SNAPSHOT_EXPORT_SCHEMA_VERSION; } });
 Object.defineProperty(exports, "IndexedDbForgeStorage", { enumerable: true, get: function () { return virtual_file_system_1.IndexedDbForgeStorage; } });
+Object.defineProperty(exports, "importWorkspaceSnapshot", { enumerable: true, get: function () { return virtual_file_system_1.importWorkspaceSnapshot; } });
 Object.defineProperty(exports, "normalizeForgePath", { enumerable: true, get: function () { return virtual_file_system_1.normalizeForgePath; } });
 Object.defineProperty(exports, "openVirtualFileSystem", { enumerable: true, get: function () { return virtual_file_system_1.openVirtualFileSystem; } });
 Object.defineProperty(exports, "resolveForgeVirtualFileSystemLimits", { enumerable: true, get: function () { return virtual_file_system_1.resolveForgeVirtualFileSystemLimits; } });

package/dist/package-resolution/diagnostics.d.ts

@@ -11,5 +11,6 @@ export declare function createPackageResolutionDiagnostic(input: ForgePackageDia
 export declare function createInvalidManifestDiagnostic(path: string, cause?: unknown): ForgePackageResolutionDiagnostic;
 export declare function createInvalidDependencyDiagnostic(dependencyName: string, requestedRange: string | undefined, message?: string): ForgePackageResolutionDiagnostic;
 export declare function createUnsupportedRangeDiagnostic(dependencyName: string, requestedRange: string): ForgePackageResolutionDiagnostic;
+export declare function createOfflineCacheMissDiagnostic(dependencyName: string, requestedRange: string): ForgePackageResolutionDiagnostic;
 export declare function createUnresolvedPackageDiagnostic(dependencyName: string, requestedRange: string): ForgePackageResolutionDiagnostic;
 export {};

package/dist/package-resolution/diagnostics.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createUnresolvedPackageDiagnostic = exports.createUnsupportedRangeDiagnostic = exports.createInvalidDependencyDiagnostic = exports.createInvalidManifestDiagnostic = exports.createPackageResolutionDiagnostic = void 0;
+exports.createUnresolvedPackageDiagnostic = exports.createOfflineCacheMissDiagnostic = exports.createUnsupportedRangeDiagnostic = exports.createInvalidDependencyDiagnostic = exports.createInvalidManifestDiagnostic = exports.createPackageResolutionDiagnostic = void 0;
 function createPackageResolutionDiagnostic(input) {
     return {
         code: input.code,
@@ -40,6 +40,15 @@ function createUnsupportedRangeDiagnostic(dependencyName, requestedRange) {
     });
 }
 exports.createUnsupportedRangeDiagnostic = createUnsupportedRangeDiagnostic;
+function createOfflineCacheMissDiagnostic(dependencyName, requestedRange) {
+    return createPackageResolutionDiagnostic({
+        code: "offline_cache_miss",
+        message: "Package is not available in the offline package cache.",
+        dependencyName,
+        requestedRange,
+    });
+}
+exports.createOfflineCacheMissDiagnostic = createOfflineCacheMissDiagnostic;
 function createUnresolvedPackageDiagnostic(dependencyName, requestedRange) {
     return createPackageResolutionDiagnostic({
         code: "unresolved_package",

package/dist/package-resolution/errors.d.ts

@@ -1,5 +1,6 @@
 import type { ForgePackageDiagnostic } from "./types";
 export declare class ForgePackageResolutionError extends Error {
     readonly diagnostic: ForgePackageDiagnostic;
-    constructor(diagnostic: ForgePackageDiagnostic);
+    readonly warnings: readonly ForgePackageDiagnostic[];
+    constructor(diagnostic: ForgePackageDiagnostic, warnings?: readonly ForgePackageDiagnostic[]);
 }

package/dist/package-resolution/errors.js

@@ -2,9 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ForgePackageResolutionError = void 0;
 class ForgePackageResolutionError extends Error {
-    constructor(diagnostic) {
+    constructor(diagnostic, warnings = []) {
         super(diagnostic.message);
         this.diagnostic = diagnostic;
+        this.warnings = warnings;
         this.name = "ForgePackageResolutionError";
     }
 }

package/dist/package-resolution/index.d.ts

@@ -1,6 +1,6 @@
 export { createCdnPackageSource, type ForgeCdnPackageFetch, type ForgeCdnPackageMetadataUrlFactory, type ForgeCdnPackageSourceOptions, } from "./cdn-source";
-export { createInvalidDependencyDiagnostic, createInvalidManifestDiagnostic, createPackageResolutionDiagnostic, createUnsupportedRangeDiagnostic, createUnresolvedPackageDiagnostic, } from "./diagnostics";
+export { createInvalidDependencyDiagnostic, createInvalidManifestDiagnostic, createOfflineCacheMissDiagnostic, createPackageResolutionDiagnostic, createUnsupportedRangeDiagnostic, createUnresolvedPackageDiagnostic, } from "./diagnostics";
 export { ForgePackageResolutionError } from "./errors";
 export { collectDependencyRequests, DEFAULT_FORGE_MANIFEST_PATH, readPackageManifest, } from "./manifest";
 export { createPackageCacheKey, createPackageResolver, DefaultPackageResolver, } from "./resolver";
-export { PACKAGE_RESOLUTION_CAPABILITY, type ForgeBundleAliases, type ForgeDependencyKind, type ForgeDependencyRequest, type ForgeImportMap, 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 "./types";
+export { PACKAGE_RESOLUTION_CAPABILITY, type ForgeBundleAliases, 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 "./types";

package/dist/package-resolution/index.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PACKAGE_RESOLUTION_CAPABILITY = exports.DefaultPackageResolver = exports.createPackageResolver = exports.createPackageCacheKey = exports.readPackageManifest = exports.DEFAULT_FORGE_MANIFEST_PATH = exports.collectDependencyRequests = exports.ForgePackageResolutionError = exports.createUnresolvedPackageDiagnostic = exports.createUnsupportedRangeDiagnostic = exports.createPackageResolutionDiagnostic = exports.createInvalidManifestDiagnostic = exports.createInvalidDependencyDiagnostic = exports.createCdnPackageSource = void 0;
+exports.PACKAGE_RESOLUTION_CAPABILITY = exports.DefaultPackageResolver = exports.createPackageResolver = exports.createPackageCacheKey = exports.readPackageManifest = exports.DEFAULT_FORGE_MANIFEST_PATH = exports.collectDependencyRequests = exports.ForgePackageResolutionError = exports.createUnresolvedPackageDiagnostic = exports.createUnsupportedRangeDiagnostic = exports.createPackageResolutionDiagnostic = exports.createOfflineCacheMissDiagnostic = exports.createInvalidManifestDiagnostic = exports.createInvalidDependencyDiagnostic = exports.createCdnPackageSource = void 0;
 var cdn_source_1 = require("./cdn-source");
 Object.defineProperty(exports, "createCdnPackageSource", { enumerable: true, get: function () { return cdn_source_1.createCdnPackageSource; } });
 var diagnostics_1 = require("./diagnostics");
 Object.defineProperty(exports, "createInvalidDependencyDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createInvalidDependencyDiagnostic; } });
 Object.defineProperty(exports, "createInvalidManifestDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createInvalidManifestDiagnostic; } });
+Object.defineProperty(exports, "createOfflineCacheMissDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createOfflineCacheMissDiagnostic; } });
 Object.defineProperty(exports, "createPackageResolutionDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createPackageResolutionDiagnostic; } });
 Object.defineProperty(exports, "createUnsupportedRangeDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createUnsupportedRangeDiagnostic; } });
 Object.defineProperty(exports, "createUnresolvedPackageDiagnostic", { enumerable: true, get: function () { return diagnostics_1.createUnresolvedPackageDiagnostic; } });

package/dist/package-resolution/resolver.d.ts

@@ -4,6 +4,8 @@ export declare class DefaultPackageResolver implements ForgePackageResolver {
     readonly capability: "package-resolution";
     private readonly sources;
     private readonly resolutionMode;
+    private readonly cacheMode;
+    private readonly telemetry;
     private readonly manifestPath;
     private readonly now;
     constructor(options: ForgePackageResolverOptions);
@@ -12,6 +14,7 @@ export declare class DefaultPackageResolver implements ForgePackageResolver {
     private resolveRequest;
     private readCachedPackage;
     private writeCachedPackage;
+    private emitTelemetry;
 }
 export declare function createPackageResolver(options: ForgePackageResolverOptions): ForgePackageResolver;
 export declare function createPackageCacheKey(packageName: string, versionOrRange: string): string;