@nindroidsystems/pluginator 2.3.0

package/dist/core/migration/migration-service.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Migration Service
+ *
+ * Handles migration of data from old file structures to new ones.
+ * Detects legacy data locations and migrates them to ~/.pluginator/
+ */
+import { LEGACY_PATHS } from '../../config/paths.js';
+/**
+ * Migration result for a single item
+ */
+export interface MigrationItemResult {
+    source: string;
+    destination: string;
+    success: boolean;
+    error?: string;
+    skipped?: boolean;
+    reason?: string;
+}
+/**
+ * Overall migration result
+ */
+export interface MigrationResult {
+    performed: boolean;
+    items: MigrationItemResult[];
+    warnings: string[];
+    timestamp: string;
+}
+/**
+ * Migration options
+ */
+export interface MigrationOptions {
+    /** Perform a dry run without actually migrating */
+    dryRun?: boolean;
+    /** Force migration even if destination exists */
+    force?: boolean;
+    /** Show deprecation warnings */
+    showWarnings?: boolean;
+    /** Callback for progress updates */
+    onProgress?: (message: string) => void;
+}
+/**
+ * Migration Service class
+ */
+export declare class MigrationService {
+    private migrationLog;
+    /**
+     * Log a migration message
+     */
+    private log;
+    /**
+     * Check if migration is needed
+     */
+    needsMigration(): boolean;
+    /**
+     * Get list of legacy items that would be migrated
+     */
+    getLegacyItems(): Array<{
+        source: string;
+        destination: string;
+        exists: boolean;
+    }>;
+    /**
+     * Perform migration from legacy structure to new structure
+     */
+    migrate(options?: MigrationOptions): Promise<MigrationResult>;
+    /**
+     * Migrate a single item
+     */
+    private migrateItem;
+    /**
+     * Convert legacy sources.json to user overrides format
+     */
+    private convertLegacySources;
+    /**
+     * Generate deprecation warnings
+     */
+    private generateDeprecationWarnings;
+    /**
+     * Save migration log to user directory
+     */
+    private saveMigrationLog;
+    /**
+     * Check if a specific legacy path exists
+     */
+    hasLegacyPath(key: keyof typeof LEGACY_PATHS): boolean;
+    /**
+     * Get migration log
+     */
+    getMigrationLog(): string[];
+}
+/**
+ * Get the singleton migration service
+ */
+export declare function getMigrationService(): MigrationService;
+/**
+ * Create a new migration service (for testing)
+ */
+export declare function createMigrationService(): MigrationService;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetMigrationService(): void;
+//# sourceMappingURL=migration-service.d.ts.map

package/dist/core/migration/migration-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-service.d.ts","sourceRoot":"","sources":["../../../src/core/migration/migration-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,YAAY,EAAoD,MAAM,uBAAuB,CAAC;AAEvG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAgB;IAEpC;;OAEG;IACH,OAAO,CAAC,GAAG;IAKX;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,cAAc,IAAI,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAmDjF;;OAEG;IACG,OAAO,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IA0CvE;;OAEG;YACW,WAAW;IAgEzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgD5B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA0BnC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,OAAO,YAAY,GAAG,OAAO;IAItD;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;CAG5B;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/core/minecraft-versions.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Minecraft Versions Service
+ *
+ * Fetches and caches Minecraft release versions from Mojang's API.
+ * Uses the unified cache system for integrity-protected storage.
+ * Provides fallback to cached data and hardcoded versions for offline use.
+ */
+/**
+ * Get Minecraft release versions.
+ *
+ * Priority:
+ * 1. Valid cache (< 24h old) - fastest
+ * 2. Fresh fetch from Mojang API
+ * 3. Stale cache (any age) - better than nothing
+ * 4. Hardcoded fallback list - last resort
+ *
+ * @param limit Maximum number of versions to return (default 10)
+ * @returns Array of version strings, newest first
+ */
+export declare function getMinecraftVersions(limit?: number): Promise<string[]>;
+/**
+ * Force refresh the version cache from Mojang API.
+ * Returns the new version list or throws if fetch fails.
+ */
+export declare function refreshMinecraftVersions(limit?: number): Promise<string[]>;
+/**
+ * Get the latest Minecraft release version.
+ */
+export declare function getLatestMinecraftVersion(): Promise<string>;
+/**
+ * Check if a version string is a valid Minecraft version format.
+ */
+export declare function isValidVersionFormat(version: string): boolean;
+/**
+ * Get cache status for Minecraft versions
+ */
+export declare function getMinecraftVersionsCacheStatus(): Promise<{
+    isCached: boolean;
+    isFresh: boolean;
+    lastFetched: string | null;
+    ageMs: number;
+}>;
+//# sourceMappingURL=minecraft-versions.d.ts.map

package/dist/core/minecraft-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minecraft-versions.d.ts","sourceRoot":"","sources":["../../src/core/minecraft-versions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6DH;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqCxE;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAM5E;AAED;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,MAAM,CAAC,CAGjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED;;GAEG;AACH,wBAAsB,+BAA+B,IAAI,OAAO,CAAC;IAC/D,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAmBD"}

package/dist/core/plugin-manager.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Plugin Manager
+ *
+ * Manages the plugin registry, providing CRUD operations
+ * and lookup functionality for configured plugins.
+ */
+import type { Plugin, PluginSourceType } from './types/index.js';
+/**
+ * Plugin Manager class
+ */
+export declare class PluginManager {
+    private plugins;
+    private pluginsPath;
+    private loaded;
+    constructor(pluginsPath?: string);
+    /**
+     * Load plugins from configuration file
+     */
+    load(): Promise<void>;
+    /**
+     * Save plugins to configuration file
+     */
+    save(): Promise<void>;
+    /**
+     * Get all plugins
+     */
+    getAll(): Plugin[];
+    /**
+     * Get plugins filtered by source type
+     */
+    getByType(type: PluginSourceType): Plugin[];
+    /**
+     * Get enabled plugins only
+     */
+    getEnabled(): Plugin[];
+    /**
+     * Find a plugin by name (case-insensitive)
+     */
+    findByName(name: string): Plugin | undefined;
+    /**
+     * Find a plugin by resource ID (Spigot)
+     */
+    findByResourceId(resourceId: string): Plugin | undefined;
+    /**
+     * Find a plugin by project slug (Modrinth)
+     */
+    findByProjectSlug(slug: string): Plugin | undefined;
+    /**
+     * Find a plugin by repo slug (GitHub)
+     */
+    findByRepoSlug(slug: string): Plugin | undefined;
+    /**
+     * Add a new plugin
+     */
+    add(plugin: Plugin): void;
+    /**
+     * Update an existing plugin
+     */
+    update(name: string, updates: Partial<Plugin>): boolean;
+    /**
+     * Remove a plugin by name
+     */
+    remove(name: string): boolean;
+    /**
+     * Get plugins that should be disabled on test server
+     */
+    getDisableOnTest(): Plugin[];
+    /**
+     * Get count of plugins
+     */
+    get count(): number;
+    /**
+     * Check if manager is loaded
+     */
+    get isLoaded(): boolean;
+    /**
+     * Get plugin source identifier for API queries
+     * Returns the appropriate identifier based on source type
+     */
+    getSourceIdentifier(plugin: Plugin): string | null;
+    /**
+     * Create a new PluginManager and load plugins
+     */
+    static create(pluginsPath?: string): Promise<PluginManager>;
+}
+/**
+ * Create a new plugin with minimal required fields
+ */
+export declare function createPlugin(name: string, type: PluginSourceType, options?: Partial<Plugin>): Plugin;
+/**
+ * Validate a plugin configuration
+ */
+export declare function validatePlugin(plugin: Plugin): string[];
+//# sourceMappingURL=plugin-manager.d.ts.map

package/dist/core/plugin-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../src/core/plugin-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAiB,MAAM,kBAAkB,CAAC;AAShF;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;gBAEX,WAAW,SAAuB;IAI9C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B3B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;IACH,MAAM,IAAI,MAAM,EAAE;IAIlB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAI3C;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK5C;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIxD;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAInD;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKhD;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASzB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO;IAcvD;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAY7B;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAqBlD;;OAEG;WACU,MAAM,CAAC,WAAW,SAAuB,GAAG,OAAO,CAAC,aAAa,CAAC;CAKhF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,GAAE,OAAO,CAAC,MAAM,CAAM,GAAG,MAAM,CAQxG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA2CvD"}

package/dist/core/preferences/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Preferences Module
+ *
+ * Exports for managing user plugin preferences
+ *
+ * @since v1.50.0
+ */
+export { PreferencesService, getPreferencesService, createPreferencesService } from './preferences-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/preferences/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/preferences/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/core/preferences/preferences-service.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Preferences Service
+ *
+ * Manages user preferences for plugins including enable/disable state,
+ * skip migration flags, pinned plugins, and notes.
+ *
+ * Data is stored in ~/.pluginator/preferences.json
+ *
+ * @since v1.50.0
+ */
+import type { PluginPreferenceState, PluginPreferences, ServerTarget } from '../types/preferences.js';
+/**
+ * Preferences Service
+ * Manages user plugin preferences
+ */
+export declare class PreferencesService {
+    private prefs;
+    private path;
+    private dirty;
+    constructor(path?: string);
+    /**
+     * Load preferences from disk
+     * Creates default preferences if file doesn't exist
+     */
+    load(): Promise<PluginPreferences>;
+    /**
+     * Save preferences to disk
+     */
+    save(): Promise<void>;
+    /**
+     * Check if there are unsaved changes
+     */
+    isDirty(): boolean;
+    /**
+     * Get current preferences object
+     */
+    getPreferences(): PluginPreferences | null;
+    /**
+     * Ensure preferences are loaded, returns the loaded prefs for convenience
+     */
+    private ensureLoaded;
+    /**
+     * Check if plugin is disabled on production
+     */
+    isDisabledOnProd(pluginName: string): boolean;
+    /**
+     * Check if plugin is disabled on test
+     */
+    isDisabledOnTest(pluginName: string): boolean;
+    /**
+     * Check if plugin is disabled on a specific server
+     */
+    isDisabled(pluginName: string, server: ServerTarget): boolean;
+    /**
+     * Set disabled state on production
+     */
+    setDisabledOnProd(pluginName: string, disabled: boolean): void;
+    /**
+     * Set disabled state on test
+     */
+    setDisabledOnTest(pluginName: string, disabled: boolean): void;
+    /**
+     * Set disabled state on a specific server or both
+     */
+    setDisabled(pluginName: string, server: ServerTarget, disabled: boolean): void;
+    /**
+     * Check if plugin should be skipped during migration
+     */
+    shouldSkipMigrate(pluginName: string): boolean;
+    /**
+     * Set skip migration flag
+     */
+    setSkipMigrate(pluginName: string, skip: boolean): void;
+    /**
+     * Get all plugins marked to skip migration
+     */
+    getSkipMigratePlugins(): string[];
+    /**
+     * Check if plugin is pinned
+     */
+    isPinned(pluginName: string): boolean;
+    /**
+     * Set pinned state
+     */
+    setPinned(pluginName: string, pinned: boolean): void;
+    /**
+     * Get all pinned plugins
+     */
+    getPinnedPlugins(): string[];
+    /**
+     * Check if plugin is a favorite
+     */
+    isFavorite(pluginName: string): boolean;
+    /**
+     * Set favorite state
+     */
+    setFavorite(pluginName: string, favorite: boolean): void;
+    /**
+     * Toggle favorite state, returns new state
+     */
+    toggleFavorite(pluginName: string): boolean;
+    /**
+     * Get all favorite plugins
+     */
+    getFavoritePlugins(): string[];
+    /**
+     * Get note for a plugin
+     */
+    getNote(pluginName: string): string | undefined;
+    /**
+     * Set note for a plugin (empty string to remove)
+     */
+    setNote(pluginName: string, note: string): void;
+    /**
+     * Get all notes
+     */
+    getAllNotes(): Record<string, string>;
+    /**
+     * Get full preference state for a plugin
+     */
+    getPluginState(pluginName: string): PluginPreferenceState;
+    /**
+     * Get preference states for multiple plugins
+     */
+    getPluginStates(pluginNames: string[]): Map<string, PluginPreferenceState>;
+    /**
+     * Remove all preferences for a plugin
+     */
+    removePlugin(pluginName: string): void;
+    /**
+     * Get statistics about preferences
+     */
+    getStats(): {
+        disabledOnProdCount: number;
+        disabledOnTestCount: number;
+        skipMigrateCount: number;
+        pinnedCount: number;
+        favoritesCount: number;
+        notesCount: number;
+    };
+}
+/**
+ * Get the singleton preferences service
+ */
+export declare function getPreferencesService(path?: string): PreferencesService;
+/**
+ * Create a new preferences service (for testing)
+ */
+export declare function createPreferencesService(path?: string): PreferencesService;
+//# sourceMappingURL=preferences-service.d.ts.map

package/dist/core/preferences/preferences-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences-service.d.ts","sourceRoot":"","sources":["../../../src/core/preferences/preferences-service.ts"],"names":[],"mappings":"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"}

package/dist/core/preview/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Preview Module
+ *
+ * Exports for dry-run / operation preview functionality.
+ *
+ * @since v1.32.0
+ */
+export { type ChangeType, type FileChange, type OperationPreview, type OperationType, type PluginUpdateInfo, type PreviewOptions, type PreviewSummary, type SyncDirection, DEFAULT_PREVIEW_OPTIONS, ESTIMATED_TIME_PER_FILE, createEmptyPreview, createEmptyPreviewSummary, getChangeColor, getChangeSymbol, } from './preview-types.js';
+export { PreviewService, type PreviewDataProvider, type ScannedFile, getPreviewService, resetPreviewService, } from './preview-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/preview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/preview/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,cAAc,EACd,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/core/preview/preview-service.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Preview Service
+ *
+ * Generates operation previews for dry-run mode.
+ *
+ * @since v1.32.0
+ */
+import { ESTIMATED_TIME_PER_FILE, type FileChange, type OperationPreview, type PluginUpdateInfo, type PreviewOptions, type PreviewSummary, type SyncDirection } from './preview-types.js';
+/**
+ * Scanned file info for comparison
+ */
+export interface ScannedFile {
+    name: string;
+    filename: string;
+    version?: string;
+    size: number;
+    path: string;
+}
+/**
+ * Data provider for preview generation
+ */
+export interface PreviewDataProvider {
+    /** Scan a directory for plugin files */
+    scanDirectory?: (path: string) => Promise<ScannedFile[]>;
+    /** Get available disk space in bytes */
+    getAvailableSpace?: () => Promise<number>;
+    /** Get production plugins path */
+    getProductionPath?: () => string | null;
+    /** Get test plugins path */
+    getTestPath?: () => string | null;
+    /** Get backup directory path */
+    getBackupPath?: () => string | null;
+}
+/**
+ * Preview service for generating operation previews
+ */
+export declare class PreviewService {
+    private provider;
+    constructor(provider?: PreviewDataProvider);
+    /**
+     * Set the data provider
+     */
+    setProvider(provider: PreviewDataProvider): void;
+    /**
+     * Preview a sync operation
+     */
+    previewSync(direction: SyncDirection, options?: PreviewOptions): Promise<OperationPreview>;
+    /**
+     * Preview a batch update operation
+     */
+    previewUpdate(plugins: PluginUpdateInfo[], options?: PreviewOptions): OperationPreview;
+    /**
+     * Preview a single download
+     */
+    previewDownload(plugin: PluginUpdateInfo, options?: PreviewOptions): OperationPreview;
+    /**
+     * Preview a backup operation
+     */
+    previewBackup(serverPath: string, options?: PreviewOptions): Promise<OperationPreview>;
+    /**
+     * Preview a restore operation
+     */
+    previewRestore(backupPath: string, targetPath: string, options?: PreviewOptions): Promise<OperationPreview>;
+    /**
+     * Preview a migrate operation (test to production with extra caution)
+     */
+    previewMigrate(options?: PreviewOptions): Promise<OperationPreview>;
+    /**
+     * Calculate summary from changes
+     */
+    calculateSummary(changes: FileChange[]): PreviewSummary;
+    /**
+     * Estimate operation duration
+     */
+    estimateDuration(changes: FileChange[], type: keyof typeof ESTIMATED_TIME_PER_FILE): number;
+    /**
+     * Calculate space required for changes
+     */
+    calculateSpaceRequired(changes: FileChange[]): number;
+    /**
+     * Generate warnings based on changes
+     */
+    generateWarnings(changes: FileChange[]): string[];
+    /**
+     * Check if version change is a downgrade
+     */
+    private isDowngrade;
+    /**
+     * Format size for display
+     */
+    formatSize(bytes: number): string;
+    /**
+     * Format duration for display
+     */
+    formatDuration(ms: number): string;
+    /**
+     * Get a human-readable summary string
+     */
+    getSummaryString(summary: PreviewSummary): string;
+}
+/**
+ * Get the singleton preview service
+ */
+export declare function getPreviewService(): PreviewService;
+/**
+ * Reset the singleton
+ */
+export declare function resetPreviewService(): void;
+//# sourceMappingURL=preview-service.d.ts.map

package/dist/core/preview/preview-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-service.d.ts","sourceRoot":"","sources":["../../../src/core/preview/preview-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,uBAAuB,EACvB,KAAK,UAAU,EACf,KAAK,gBAAgB,EAErB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAGnB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACxC,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAsB;gBAE1B,QAAQ,GAAE,mBAAwB;IAI9C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAQhD;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgGhG;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,gBAAgB;IA8BtF;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,gBAAgB;IAQrF;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+B5F;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiEjH;;OAEG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkBzE;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,cAAc;IAoCvD;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,OAAO,uBAAuB,GAAG,MAAM;IAM3F;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM;IAerD;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE;IAkBjD;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAOjC;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAMlC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM;CAelD;AAQD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}