esengine/packages/asset-system/src/index.ts

/**
 * Asset System for ECS Framework
 * ECS框架的资产系统
 *
 * Runtime-focused asset management:
 * - Asset loading and caching
 * - GUID-based asset resolution
 * - Bundle loading
 *
 * For editor-side functionality (meta files, packing), use @esengine/asset-system-editor
 */

// Service tokens (谁定义接口，谁导出 Token)
export {
    AssetManagerToken,
    PrefabServiceToken,
    PathResolutionServiceToken,
    type IAssetManager,
    type IPrefabService,
    type IPrefabAsset,
    type IPrefabData,
    type IPrefabMetadata,
    type IPathResolutionService
} from './tokens';

// Types
export * from './types/AssetTypes';

// Bundle format (shared types for runtime and editor)
export * from './bundle/BundleFormat';

// Runtime catalog
export { RuntimeCatalog, runtimeCatalog } from './runtime/RuntimeCatalog';

// Interfaces
export * from './interfaces/IAssetLoader';
export * from './interfaces/IAssetManager';
export * from './interfaces/IAssetReader';
export * from './interfaces/IAssetFileLoader';
export * from './interfaces/IResourceComponent';

// Core
export { AssetManager } from './core/AssetManager';
export { AssetCache } from './core/AssetCache';
export { AssetDatabase } from './core/AssetDatabase';
export { AssetLoadQueue } from './core/AssetLoadQueue';
export { AssetReference, WeakAssetReference, AssetReferenceArray } from './core/AssetReference';
export { AssetPathResolver } from './core/AssetPathResolver';
export type { IAssetPathConfig } from './core/AssetPathResolver';

// Loaders
export { AssetLoaderFactory } from './loaders/AssetLoaderFactory';
export { TextureLoader } from './loaders/TextureLoader';
export { JsonLoader } from './loaders/JsonLoader';
export { TextLoader } from './loaders/TextLoader';
export { BinaryLoader } from './loaders/BinaryLoader';
export { AudioLoader } from './loaders/AudioLoader';
export { PrefabLoader } from './loaders/PrefabLoader';

// Integration
export { EngineIntegration } from './integration/EngineIntegration';
export type { ITextureEngineBridge, TextureLoadCallback } from './integration/EngineIntegration';

// Services
export { SceneResourceManager } from './services/SceneResourceManager';
export type { IResourceLoader } from './services/SceneResourceManager';
export { PathResolutionService } from './services/PathResolutionService';

// Asset Metadata Service (primary API for sprite info)
// 资产元数据服务（sprite 信息的主要 API）
export {
    setGlobalAssetDatabase,
    getGlobalAssetDatabase,
    setGlobalEngineBridge,
    getGlobalEngineBridge,
    getTextureSpriteInfo
} from './services/AssetMetadataService';
export type { ITextureSpriteInfo } from './core/AssetDatabase';

// Utils
export { UVHelper } from './utils/UVHelper';
export {
    isValidGUID,
    generateGUID,
    hashBuffer,
    hashString,
    hashFileInfo
} from './utils/AssetUtils';
export {
    collectAssetReferences,
    extractUniqueGuids,
    groupByComponentType,
    DEFAULT_ASSET_PATTERNS,
    type SceneAssetRef,
    type AssetFieldPattern
} from './utils/AssetCollector';

// Re-export for initializeAssetSystem
import { AssetManager } from './core/AssetManager';
import type { IAssetCatalog } from './types/AssetTypes';

/**
 * Initialize asset system with catalog
 * 使用目录初始化资产系统
 *
 * @param catalog 资产目录 | Asset catalog
 * @returns 新的 AssetManager 实例 | New AssetManager instance
 */
export function initializeAssetSystem(catalog?: IAssetCatalog): AssetManager {
    return new AssetManager(catalog);
}