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

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,14 +51,17 @@ export interface ForgeDevSession {
     readonly diagnostics: readonly ForgeDevSessionDiagnostic[];
     readonly buildResult?: ForgeBuildResult;
     readonly previewDocument?: ForgePreviewDocument;
+    readonly errorOverlayDocument?: ForgePreviewDocument;
 }
 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;
@@ -55,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;
@@ -70,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;
@@ -85,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/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 { 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 { 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, 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 { 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.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; } });
@@ -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; } });
@@ -46,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; } });
@@ -66,22 +69,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;

package/dist/package-resolution/resolver.js

@@ -1,17 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createPackageCacheKey = exports.createPackageResolver = exports.DefaultPackageResolver = void 0;
+const virtual_file_system_1 = require("../virtual-file-system");
+const telemetry_1 = require("../telemetry");
 const manifest_1 = require("./manifest");
 const diagnostics_1 = require("./diagnostics");
 const errors_1 = require("./errors");
 const types_1 = require("./types");
 const DEFAULT_RESOLUTION_MODE = "bundle-alias";
+const DEFAULT_CACHE_MODE = "prefer-cache";
 class DefaultPackageResolver {
     constructor(options) {
         this.options = options;
         this.capability = types_1.PACKAGE_RESOLUTION_CAPABILITY;
         this.sources = options.sources ?? [];
         this.resolutionMode = options.resolutionMode ?? DEFAULT_RESOLUTION_MODE;
+        this.cacheMode = options.cacheMode ?? DEFAULT_CACHE_MODE;
+        this.telemetry = options.telemetry;
         this.manifestPath = options.manifestPath ?? manifest_1.DEFAULT_FORGE_MANIFEST_PATH;
         this.now = options.now ?? (() => new Date().toISOString());
     }
@@ -19,38 +24,86 @@ class DefaultPackageResolver {
         return (0, manifest_1.readPackageManifest)(this.options.fileSystem, manifestPath);
     }
     async resolve(options = {}) {
-        const manifest = await this.readManifest(options.manifestPath ?? this.manifestPath);
-        const requests = (0, manifest_1.collectDependencyRequests)(manifest);
+        const telemetryStart = (0, telemetry_1.startForgeTelemetryTiming)(this.now());
+        const telemetry = options.telemetry ?? this.telemetry;
         const sources = options.sources ?? this.sources;
         const resolutionMode = options.resolutionMode ?? this.resolutionMode;
-        const packages = [];
-        for (const request of requests) {
-            packages.push(await this.resolveRequest(request, sources));
-        }
-        packages.sort((left, right) => left.name.localeCompare(right.name));
-        const lock = createLockMetadata(packages, resolutionMode);
-        const resultBase = {
-            manifest,
-            requests,
-            packages,
-            lock,
-            warnings: [],
-        };
-        if (resolutionMode === "import-map") {
-            return {
-                ...resultBase,
-                importMap: createImportMap(packages),
+        const cacheMode = options.cacheMode ?? this.cacheMode;
+        let requests;
+        try {
+            const manifest = await this.readManifest(options.manifestPath ?? this.manifestPath);
+            requests = (0, manifest_1.collectDependencyRequests)(manifest);
+            const packages = [];
+            const warnings = [];
+            for (const request of requests) {
+                try {
+                    const result = await this.resolveRequest(request, sources, cacheMode);
+                    packages.push(result.packageRecord);
+                    warnings.push(...result.warnings);
+                }
+                catch (error) {
+                    if (error instanceof errors_1.ForgePackageResolutionError &&
+                        (warnings.length > 0 || error.warnings.length > 0)) {
+                        throw new errors_1.ForgePackageResolutionError(error.diagnostic, [
+                            ...warnings,
+                            ...error.warnings,
+                        ]);
+                    }
+                    throw error;
+                }
+            }
+            packages.sort((left, right) => left.name.localeCompare(right.name));
+            const lock = createLockMetadata(packages, resolutionMode);
+            const resultBase = {
+                manifest,
+                requests,
+                packages,
+                lock,
+                warnings,
             };
+            const result = resolutionMode === "import-map"
+                ? {
+                    ...resultBase,
+                    importMap: createImportMap(packages),
+                }
+                : {
+                    ...resultBase,
+                    aliases: createBundleAliases(packages),
+                };
+            this.emitTelemetry(telemetry, telemetryStart, {
+                cacheMode,
+                dependencyCount: requests.length,
+                diagnostics: warnings,
+                outcome: "success",
+                packageCount: packages.length,
+                resolutionMode,
+            });
+            return result;
+        }
+        catch (error) {
+            if (error instanceof errors_1.ForgePackageResolutionError) {
+                this.emitTelemetry(telemetry, telemetryStart, {
+                    cacheMode,
+                    dependencyCount: requests?.length,
+                    diagnostics: [error.diagnostic, ...error.warnings],
+                    outcome: "failure",
+                    packageCount: undefined,
+                    resolutionMode,
+                });
+            }
+            throw error;
         }
-        return {
-            ...resultBase,
-            aliases: createBundleAliases(packages),
-        };
     }
-    async resolveRequest(request, sources) {
+    async resolveRequest(request, sources, cacheMode) {
         const cachedPackage = await this.readCachedPackage(request);
         if (cachedPackage !== undefined) {
-            return cachedPackage;
+            return {
+                packageRecord: cachedPackage,
+                warnings: [],
+            };
+        }
+        if (cacheMode === "cache-only") {
+            throw new errors_1.ForgePackageResolutionError((0, diagnostics_1.createOfflineCacheMissDiagnostic)(request.name, request.requestedRange));
         }
         for (const source of sources) {
             const packageRecord = await source.resolvePackage(request);
@@ -58,8 +111,11 @@ class DefaultPackageResolver {
                 continue;
             }
             const normalizedRecord = normalizePackageRecord(request, source.id, packageRecord);
-            await this.writeCachedPackage(request, normalizedRecord);
-            return normalizedRecord;
+            const warnings = await this.writeCachedPackage(request, normalizedRecord);
+            return {
+                packageRecord: normalizedRecord,
+                warnings,
+            };
         }
         throw new errors_1.ForgePackageResolutionError((0, diagnostics_1.createUnresolvedPackageDiagnostic)(request.name, request.requestedRange));
     }
@@ -78,8 +134,9 @@ class DefaultPackageResolver {
     }
     async writeCachedPackage(request, packageRecord) {
         if (this.options.storage === undefined) {
-            return;
+            return [];
         }
+        const warnings = [];
         const records = [
             createCacheRecord(createPackageCacheKey(request.name, request.requestedRange), packageRecord, this.now()),
         ];
@@ -87,8 +144,35 @@ class DefaultPackageResolver {
             records.push(createCacheRecord(createPackageCacheKey(request.name, packageRecord.version), packageRecord, this.now()));
         }
         for (const record of records) {
-            await this.options.storage.putPackageCacheRecord(record);
+            try {
+                await this.options.storage.putPackageCacheRecord(record);
+            }
+            catch (error) {
+                if (isLimitExceededError(error)) {
+                    warnings.push(toWarningDiagnostic(error.diagnostic));
+                    continue;
+                }
+                throw error;
+            }
         }
+        return warnings;
+    }
+    emitTelemetry(telemetry, telemetryStart, input) {
+        const diagnosticSummaries = (0, telemetry_1.summarizeForgeTelemetryDiagnostics)(input.diagnostics);
+        const errorDiagnostic = input.diagnostics.find((diagnostic) => diagnostic.severity === "error");
+        (0, telemetry_1.emitForgeTelemetry)(telemetry, {
+            operation: "package-resolution",
+            outcome: input.outcome,
+            ...(0, telemetry_1.completeForgeTelemetryTiming)(telemetryStart, this.now()),
+            cacheMode: input.cacheMode,
+            resolutionMode: input.resolutionMode,
+            dependencyCount: input.dependencyCount,
+            packageCount: input.packageCount,
+            diagnostics: diagnosticSummaries,
+            unsupportedPackageReason: errorDiagnostic === undefined
+                ? undefined
+                : (0, telemetry_1.createForgeUnsupportedPackageReason)(errorDiagnostic),
+        });
     }
 }
 exports.DefaultPackageResolver = DefaultPackageResolver;
@@ -170,3 +254,13 @@ function isForgePackageRecord(value) {
         typeof record.files === "object" &&
         record.files !== null);
 }
+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/package-resolution/types.d.ts

@@ -1,8 +1,10 @@
 import type { ForgeDiagnostic, ForgeVirtualFileSystemStorage } from "../virtual-file-system";
 import type { ForgeVirtualFileSystem } from "../virtual-file-system";
+import type { ForgeTelemetryReporter } from "../telemetry";
 export declare const PACKAGE_RESOLUTION_CAPABILITY: "package-resolution";
 export type ForgePackageResolutionMode = "import-map" | "bundle-alias";
-export type ForgePackageResolutionDiagnosticCode = "invalid_dependency" | "invalid_manifest" | "unresolved_package" | "unsupported_range";
+export type ForgePackageCacheMode = "prefer-cache" | "cache-only";
+export type ForgePackageResolutionDiagnosticCode = "invalid_dependency" | "invalid_manifest" | "offline_cache_miss" | "unresolved_package" | "unsupported_range";
 export interface ForgePackageResolutionDiagnostic {
     readonly code: ForgePackageResolutionDiagnosticCode;
     readonly severity: "error";
@@ -74,12 +76,16 @@ export interface ForgePackageResolverOptions {
     readonly storage?: ForgeVirtualFileSystemStorage;
     readonly sources?: readonly ForgePackageSource[];
     readonly resolutionMode?: ForgePackageResolutionMode;
+    readonly cacheMode?: ForgePackageCacheMode;
+    readonly telemetry?: ForgeTelemetryReporter;
     readonly manifestPath?: string;
     readonly now?: () => string;
 }
 export interface ForgeResolvePackagesOptions {
     readonly sources?: readonly ForgePackageSource[];
     readonly resolutionMode?: ForgePackageResolutionMode;
+    readonly cacheMode?: ForgePackageCacheMode;
+    readonly telemetry?: ForgeTelemetryReporter;
     readonly manifestPath?: string;
 }
 export interface ForgePackageResolutionResult {

package/dist/telemetry/index.d.ts

@@ -0,0 +1,68 @@
+export declare const TELEMETRY_CAPABILITY: "telemetry";
+export type ForgeTelemetryOperation = "build" | "package-resolution";
+export type ForgeTelemetryOutcome = "failure" | "success";
+export interface ForgeTelemetryTiming {
+    readonly startedAt: string;
+    readonly endedAt: string;
+    readonly durationMs: number;
+}
+export interface ForgeTelemetryTimingStart {
+    readonly startedAt: string;
+    readonly startedMs: number;
+}
+export interface ForgeTelemetryDiagnosticSummary {
+    readonly code: string;
+    readonly severity: "error" | "info" | "warning";
+    readonly message: string;
+    readonly path?: string;
+    readonly dependencyName?: string;
+    readonly requestedRange?: string;
+    readonly importer?: string;
+    readonly importSpecifier?: string;
+    readonly limitName?: string;
+}
+export interface ForgeUnsupportedPackageReason {
+    readonly code: string;
+    readonly message: string;
+    readonly dependencyName?: string;
+    readonly requestedRange?: string;
+}
+export interface ForgePackageResolutionTelemetryEvent extends ForgeTelemetryTiming {
+    readonly operation: "package-resolution";
+    readonly outcome: ForgeTelemetryOutcome;
+    readonly cacheMode: string;
+    readonly resolutionMode: string;
+    readonly dependencyCount?: number;
+    readonly packageCount?: number;
+    readonly diagnostics: readonly ForgeTelemetryDiagnosticSummary[];
+    readonly unsupportedPackageReason?: ForgeUnsupportedPackageReason;
+}
+export interface ForgeBuildTelemetryEvent extends ForgeTelemetryTiming {
+    readonly operation: "build";
+    readonly outcome: ForgeTelemetryOutcome;
+    readonly mode: string;
+    readonly entry?: string;
+    readonly outputFileCount: number;
+    readonly packageCount?: number;
+    readonly diagnostics: readonly ForgeTelemetryDiagnosticSummary[];
+}
+export type ForgeTelemetryEvent = ForgeBuildTelemetryEvent | ForgePackageResolutionTelemetryEvent;
+export type ForgeTelemetryReporter = (event: ForgeTelemetryEvent) => void;
+export interface ForgeTelemetryDiagnosticLike {
+    readonly code: string;
+    readonly severity: "error" | "info" | "warning";
+    readonly message: string;
+    readonly path?: string;
+    readonly dependencyName?: string;
+    readonly requestedRange?: string;
+    readonly importer?: string;
+    readonly importSpecifier?: string;
+    readonly limit?: {
+        readonly name?: string;
+    };
+}
+export declare function startForgeTelemetryTiming(startedAt: string): ForgeTelemetryTimingStart;
+export declare function completeForgeTelemetryTiming(start: ForgeTelemetryTimingStart, endedAt: string): ForgeTelemetryTiming;
+export declare function summarizeForgeTelemetryDiagnostics(diagnostics: readonly ForgeTelemetryDiagnosticLike[]): readonly ForgeTelemetryDiagnosticSummary[];
+export declare function createForgeUnsupportedPackageReason(diagnostic: ForgeTelemetryDiagnosticLike): ForgeUnsupportedPackageReason | undefined;
+export declare function emitForgeTelemetry(reporter: ForgeTelemetryReporter | undefined, event: ForgeTelemetryEvent): void;