@nice2dev/game-engine 1.1.5 → 1.1.7

package/dist/types/unreal-integration/UnrealMarketplace.d.ts

@@ -0,0 +1,360 @@
+/**
+ * @file UnrealMarketplace.ts
+ * @description Unreal Engine Marketplace Integration for Nice2Dev Game Engine
+ * PRO-1.10.3: Unreal Marketplace Integration
+ *
+ * Features:
+ * - Marketplace asset browser
+ * - Asset vault management
+ * - Download and installation
+ * - Asset dependency resolution
+ * - Version compatibility checking
+ * - Fab.com integration
+ */
+export type MarketplaceCategory = '2D Assets' | '3D Assets' | 'Animations' | 'Environments' | 'Characters' | 'Weapons' | 'Vehicles' | 'Architecture' | 'Props' | 'Materials' | 'Textures' | 'Audio' | 'Music' | 'Sound Effects' | 'Blueprints' | 'Code Plugins' | 'Complete Projects' | 'Games' | 'Showcases' | 'VFX' | 'UI' | 'Templates' | string;
+export type AssetPlatform = 'Windows' | 'Mac' | 'Linux' | 'Android' | 'iOS' | 'PS4' | 'PS5' | 'XboxOne' | 'XboxSeriesX' | 'Switch' | string;
+export type ContentRating = 'Everyone' | 'Teen' | 'Mature';
+export type AssetStatus = 'Available' | 'Owned' | 'Installed' | 'UpdateAvailable' | 'Downloading' | 'Installing' | 'Error';
+export interface MarketplaceAsset {
+    id: string;
+    slug: string;
+    title: string;
+    shortDescription: string;
+    longDescription: string;
+    seller: SellerInfo;
+    category: MarketplaceCategory;
+    subcategories: string[];
+    tags: string[];
+    price: PriceInfo;
+    rating: RatingInfo;
+    images: AssetImage[];
+    videos: AssetVideo[];
+    technicalDetails: TechnicalDetails;
+    compatibility: CompatibilityInfo;
+    releaseInfo: ReleaseInfo;
+    statistics: AssetStatistics;
+    isFeatured: boolean;
+    isOnSale: boolean;
+    isFree: boolean;
+    contentRating: ContentRating;
+}
+export interface SellerInfo {
+    id: string;
+    name: string;
+    verified: boolean;
+    supportEmail?: string;
+    website?: string;
+    assetCount: number;
+}
+export interface PriceInfo {
+    amount: number;
+    currency: string;
+    originalAmount?: number;
+    discountPercent?: number;
+    saleEndDate?: Date;
+}
+export interface RatingInfo {
+    average: number;
+    count: number;
+    distribution: Record<1 | 2 | 3 | 4 | 5, number>;
+}
+export interface AssetImage {
+    id: string;
+    url: string;
+    thumbnailUrl: string;
+    width: number;
+    height: number;
+    type: 'screenshot' | 'thumbnail' | 'gallery' | 'featured';
+    caption?: string;
+}
+export interface AssetVideo {
+    id: string;
+    url: string;
+    thumbnailUrl: string;
+    type: 'youtube' | 'vimeo' | 'direct';
+    duration?: number;
+    title?: string;
+}
+export interface TechnicalDetails {
+    engineVersions: string[];
+    platforms: AssetPlatform[];
+    fileSize: number;
+    polyCount?: PolyCountRange;
+    textureResolutions?: string[];
+    rigged?: boolean;
+    animated?: boolean;
+    lods?: number;
+    vertexCount?: number;
+    materialCount?: number;
+    meshCount?: number;
+    blueprintCount?: number;
+    textureCount?: number;
+    includedFormats?: string[];
+    documentation?: string;
+    networkReplicated?: boolean;
+}
+export interface PolyCountRange {
+    min: number;
+    max: number;
+    average?: number;
+}
+export interface CompatibilityInfo {
+    minEngineVersion: string;
+    maxEngineVersion: string;
+    testedVersions: string[];
+    supportedPlatforms: AssetPlatform[];
+    dependencies?: string[];
+    requiredPlugins?: string[];
+}
+export interface ReleaseInfo {
+    releaseDate: Date;
+    lastUpdate: Date;
+    version: string;
+    changelog?: ChangelogEntry[];
+}
+export interface ChangelogEntry {
+    version: string;
+    date: Date;
+    changes: string[];
+}
+export interface AssetStatistics {
+    downloads: number;
+    favorites: number;
+    views: number;
+    purchases: number;
+}
+export interface MarketplaceSearchParams {
+    query?: string;
+    category?: MarketplaceCategory;
+    subcategory?: string;
+    tags?: string[];
+    minPrice?: number;
+    maxPrice?: number;
+    freeOnly?: boolean;
+    onSaleOnly?: boolean;
+    minRating?: number;
+    engineVersion?: string;
+    platforms?: AssetPlatform[];
+    sortBy?: 'relevance' | 'newest' | 'rating' | 'price-low' | 'price-high' | 'popular' | 'trending';
+    page?: number;
+    pageSize?: number;
+    sellerId?: string;
+}
+export interface MarketplaceSearchResult {
+    assets: MarketplaceAsset[];
+    totalCount: number;
+    page: number;
+    pageSize: number;
+    hasMore: boolean;
+    facets?: SearchFacets;
+}
+export interface SearchFacets {
+    categories: {
+        name: MarketplaceCategory;
+        count: number;
+    }[];
+    priceRanges: {
+        min: number;
+        max: number;
+        count: number;
+    }[];
+    engineVersions: {
+        version: string;
+        count: number;
+    }[];
+    platforms: {
+        platform: AssetPlatform;
+        count: number;
+    }[];
+    ratings: {
+        rating: number;
+        count: number;
+    }[];
+}
+export interface VaultAsset {
+    assetId: string;
+    title: string;
+    thumbnailUrl: string;
+    installedVersion?: string;
+    latestVersion: string;
+    installedPath?: string;
+    installDate?: Date;
+    lastUsedDate?: Date;
+    fileSize: number;
+    status: AssetStatus;
+    engineVersion: string;
+    category: MarketplaceCategory;
+    autoUpdate: boolean;
+}
+export interface VaultProject {
+    name: string;
+    path: string;
+    engineVersion: string;
+    usedAssets: string[];
+    lastOpened: Date;
+}
+export interface DownloadProgress {
+    assetId: string;
+    state: 'pending' | 'downloading' | 'extracting' | 'installing' | 'complete' | 'error';
+    progress: number;
+    bytesDownloaded: number;
+    totalBytes: number;
+    speed: number;
+    eta: number;
+    error?: string;
+}
+export declare class UnrealMarketplaceBrowser {
+    private apiEndpoint;
+    private fabEndpoint;
+    private authToken;
+    private cache;
+    private cacheTTL;
+    constructor(authToken?: string);
+    setAuthToken(token: string): void;
+    isAuthenticated(): boolean;
+    searchAssets(params: MarketplaceSearchParams): Promise<MarketplaceSearchResult>;
+    getAssetDetails(assetId: string): Promise<MarketplaceAsset>;
+    getAssetBySlug(slug: string): Promise<MarketplaceAsset>;
+    getCategories(): Promise<{
+        name: MarketplaceCategory;
+        count: number;
+        subcategories: string[];
+    }[]>;
+    getFeaturedAssets(): Promise<MarketplaceAsset[]>;
+    getNewReleases(limit?: number): Promise<MarketplaceAsset[]>;
+    getOnSaleAssets(limit?: number): Promise<MarketplaceAsset[]>;
+    getFreeAssets(limit?: number): Promise<MarketplaceAsset[]>;
+    getTopRated(limit?: number): Promise<MarketplaceAsset[]>;
+    getTrending(limit?: number): Promise<MarketplaceAsset[]>;
+    getSellerInfo(sellerId: string): Promise<SellerInfo>;
+    getSellerAssets(sellerId: string, page?: number): Promise<MarketplaceSearchResult>;
+    getAssetReviews(assetId: string, page?: number): Promise<{
+        reviews: AssetReview[];
+        totalCount: number;
+    }>;
+    getAssetQuestions(assetId: string, page?: number): Promise<{
+        questions: AssetQuestion[];
+        totalCount: number;
+    }>;
+    checkEngineCompatibility(asset: MarketplaceAsset, engineVersion: string): CompatibilityResult;
+    private getFromCache;
+    private setInCache;
+    clearCache(): void;
+    private apiRequest;
+}
+export declare class UnrealVaultManager {
+    private vaultPath;
+    private assets;
+    private projects;
+    private downloadQueue;
+    private callbacks;
+    constructor(vaultPath: string);
+    loadVault(): Promise<void>;
+    saveVault(): Promise<void>;
+    getOwnedAssets(): VaultAsset[];
+    getInstalledAssets(): VaultAsset[];
+    getAssetStatus(assetId: string): AssetStatus;
+    isAssetOwned(assetId: string): boolean;
+    isAssetInstalled(assetId: string): boolean;
+    downloadAsset(assetId: string, _targetPath?: string): Promise<void>;
+    installAsset(assetId: string, projectPath: string): Promise<void>;
+    uninstallAsset(assetId: string, projectPath: string): Promise<void>;
+    updateAsset(assetId: string): Promise<void>;
+    cancelDownload(assetId: string): void;
+    getDownloadProgress(assetId: string): DownloadProgress | undefined;
+    registerProject(project: VaultProject): void;
+    unregisterProject(projectPath: string): void;
+    getProjectAssets(projectPath: string): VaultAsset[];
+    getAssetsUsedInProject(projectPath: string): string[];
+    checkForUpdates(): Promise<VaultAsset[]>;
+    setAutoUpdate(assetId: string, enabled: boolean): void;
+    getVaultSize(): number;
+    getInstalledSize(): number;
+    setCallbacks(callbacks: VaultCallbacks): void;
+}
+export interface AssetReview {
+    id: string;
+    userId: string;
+    userName: string;
+    rating: number;
+    title?: string;
+    content: string;
+    date: Date;
+    helpful: number;
+    verified: boolean;
+    version: string;
+    response?: {
+        content: string;
+        date: Date;
+    };
+}
+export interface AssetQuestion {
+    id: string;
+    userId: string;
+    userName: string;
+    question: string;
+    date: Date;
+    answered: boolean;
+    answer?: {
+        content: string;
+        date: Date;
+        isOfficial: boolean;
+    };
+}
+export interface CompatibilityResult {
+    compatible: boolean;
+    tested?: boolean;
+    reason: string;
+    suggestedVersion?: string;
+}
+export interface VaultCallbacks {
+    onDownloadStart?: (assetId: string) => void;
+    onDownloadProgress?: (assetId: string, progress: DownloadProgress) => void;
+    onDownloadComplete?: (assetId: string) => void;
+    onDownloadError?: (assetId: string, error: Error) => void;
+    onDownloadCancelled?: (assetId: string) => void;
+    onInstallStart?: (assetId: string, projectPath: string) => void;
+    onInstallComplete?: (assetId: string, projectPath: string) => void;
+    onInstallError?: (assetId: string, error: Error) => void;
+}
+export declare class FabBrowser {
+    private apiEndpoint;
+    private authToken;
+    constructor(authToken?: string);
+    setAuthToken(token: string): void;
+    searchAssets(query: string, filters?: FabSearchFilters): Promise<FabSearchResult>;
+    getAssetDetails(_assetId: string): Promise<FabAsset>;
+    importToUnreal(assetId: string, projectPath: string): Promise<void>;
+}
+export interface FabSearchFilters {
+    assetType?: 'hdri' | 'material' | '3d' | '2d' | 'audio' | 'all';
+    source?: 'megascans' | 'sketchfab' | 'marketplace' | 'all';
+    priceRange?: {
+        min: number;
+        max: number;
+    };
+    license?: 'standard' | 'extended' | 'all';
+}
+export interface FabSearchResult {
+    results: FabAsset[];
+    totalCount: number;
+    page: number;
+    hasMore: boolean;
+}
+export interface FabAsset {
+    id: string;
+    title: string;
+    description: string;
+    source: 'megascans' | 'sketchfab' | 'marketplace' | 'other';
+    thumbnailUrl: string;
+    price: number;
+    currency: string;
+    formats: string[];
+    license: string;
+    creator: string;
+    downloads: number;
+    rating: number;
+}
+export declare function createUnrealMarketplaceBrowser(authToken?: string): UnrealMarketplaceBrowser;
+export declare function createUnrealVaultManager(vaultPath: string): UnrealVaultManager;
+export declare function createFabBrowser(authToken?: string): FabBrowser;

package/dist/types/unreal-integration/components/UnrealProjectBrowser.d.ts

@@ -0,0 +1,98 @@
+import React from 'react';
+export interface UnrealAsset {
+    id: string;
+    name: string;
+    path: string;
+    type: 'blueprint' | 'level' | 'material' | 'texture' | 'mesh' | 'skeletal_mesh' | 'animation' | 'sound' | 'particle' | 'widget' | 'data_asset' | 'other';
+    className: string;
+    packagePath: string;
+    size: number;
+    lastModified: string;
+    dependencies?: string[];
+    thumbnail?: string;
+    selected: boolean;
+}
+export interface UnrealFolder {
+    path: string;
+    name: string;
+    children: (UnrealFolder | UnrealAsset)[];
+    expanded: boolean;
+    color?: string;
+}
+export interface UnrealProjectInfo {
+    name: string;
+    path: string;
+    engineVersion: string;
+    engineBranch: string;
+    targetPlatforms: string[];
+    plugins: Array<{
+        name: string;
+        enabled: boolean;
+        version: string;
+        category: string;
+    }>;
+    modules: Array<{
+        name: string;
+        type: 'Runtime' | 'Editor' | 'Developer';
+        loadingPhase: string;
+    }>;
+    assets: UnrealAsset[];
+    contentFolder: UnrealFolder;
+    maps: Array<{
+        name: string;
+        path: string;
+        persistent: boolean;
+    }>;
+    config: {
+        defaultMap: string;
+        defaultGameMode: string;
+        defaultPawn: string;
+    };
+}
+export interface UnrealLiveLinkStatus {
+    connected: boolean;
+    engineVersion?: string;
+    projectName?: string;
+    playState: 'stopped' | 'playing' | 'paused' | 'simulating';
+    compiling: boolean;
+    hotReloadAvailable: boolean;
+    lastHotReload?: string;
+}
+export interface UnrealProjectBrowserTheme {
+    background: string;
+    panelBackground: string;
+    headerBackground: string;
+    itemBackground: string;
+    itemHover: string;
+    itemSelected: string;
+    textPrimary: string;
+    textSecondary: string;
+    accent: string;
+    success: string;
+    warning: string;
+    danger: string;
+    border: string;
+    unrealBlack: string;
+    blueprintBlue: string;
+    cppOrange: string;
+    contentBrowserGray: string;
+}
+export interface UnrealProjectBrowserProps {
+    projectPath?: string;
+    theme?: Partial<UnrealProjectBrowserTheme>;
+    onProjectLoad?: (info: UnrealProjectInfo) => void;
+    onImport?: (assets: UnrealAsset[]) => Promise<void>;
+    onLiveLinkConnect?: () => Promise<UnrealLiveLinkStatus>;
+    onLiveLinkDisconnect?: () => void;
+    onHotReload?: () => Promise<void>;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export interface UnrealProjectBrowserRef {
+    loadProject: (path: string) => Promise<void>;
+    getSelectedAssets: () => UnrealAsset[];
+    importSelected: () => Promise<void>;
+    triggerHotReload: () => Promise<void>;
+}
+export declare const UnrealProjectBrowser: React.ForwardRefExoticComponent<UnrealProjectBrowserProps & React.RefAttributes<UnrealProjectBrowserRef>>;
+export default UnrealProjectBrowser;

package/dist/types/unreal-integration/components/index.d.ts

@@ -0,0 +1 @@
+export { UnrealProjectBrowser, type UnrealProjectBrowserProps, type UnrealProjectBrowserRef, type UnrealProjectBrowserTheme, type UnrealAsset, type UnrealFolder, type UnrealProjectInfo, type UnrealLiveLinkStatus, } from './UnrealProjectBrowser';

package/dist/types/unreal-integration/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @file index.ts
+ * @description Unreal Engine Integration exports for Nice2Dev Game Engine
+ * PRO-1.10: Unreal Engine Deep Integration
+ */
+export type { UnrealActorType, UnrealComponentType, UnrealAssetType, BlueprintNodeType, UnrealProject, UnrealModule, UnrealPluginReference, UnrealLevel, UnrealLevelReference, UnrealWorldSettings, UnrealLightmapInfo, UnrealActor, UnrealComponent, UnrealTransform, UnrealBlueprint, BlueprintVariable, BlueprintVariableFlags, BlueprintFunction, BlueprintFunctionParam, BlueprintFunctionFlags, BlueprintGraph, BlueprintNode, BlueprintPin, BlueprintPinType, BlueprintComment, BlueprintMacro, BlueprintComponentNode, BlueprintDelegateSignature, UnrealAssetReference, UnrealMaterialData, MaterialParameter, MaterialTextureParameter, MaterialScalarParameter, MaterialVectorParameter, MaterialStaticSwitchParameter, ImportProgress, ImportCallbacks, ImportedUnrealProject, } from './UnrealImport';
+export { UnrealProjectImporter, UNREAL_ACTOR_MAPPING, UNREAL_COMPONENT_MAPPING, createUnrealProjectImporter, } from './UnrealImport';
+export type { LiveLinkMessageType, LiveLinkMessage, HandshakePayload, ActorSelectionPayload, ActorTransformPayload, PropertyChangePayload, PIEStatePayload, LiveCodingPayload, LogMessagePayload, ExecuteCommandPayload, BreakpointPayload, StackFrame, VariableInfo, LiveLinkConnectionOptions, LiveLinkConnectionState, LiveLinkCallbacks, UnrealPluginOptions, } from './UnrealLiveLink';
+export { UnrealLiveLinkClient, generateUnrealEditorPlugin, createUnrealLiveLinkClient, } from './UnrealLiveLink';
+export type { MarketplaceCategory, AssetPlatform, ContentRating, AssetStatus, MarketplaceAsset, SellerInfo, PriceInfo, RatingInfo, AssetImage, AssetVideo, TechnicalDetails, PolyCountRange, CompatibilityInfo, ReleaseInfo, ChangelogEntry, AssetStatistics, MarketplaceSearchParams, MarketplaceSearchResult, SearchFacets, VaultAsset, VaultProject, DownloadProgress, AssetReview, AssetQuestion, CompatibilityResult, VaultCallbacks, FabSearchFilters, FabSearchResult, FabAsset, } from './UnrealMarketplace';
+export { UnrealMarketplaceBrowser, UnrealVaultManager, FabBrowser, createUnrealMarketplaceBrowser, createUnrealVaultManager, createFabBrowser, } from './UnrealMarketplace';
+export * from './components';

package/dist/types/visual-scripting/VisualScriptDebugger.d.ts

@@ -0,0 +1,145 @@
+import { type DebuggerState, type Breakpoint, type DebuggerMode } from './types';
+export type DebuggerEventType = 'breakpoint_hit' | 'step_complete' | 'paused' | 'resumed' | 'error' | 'variable_changed' | 'call_stack_changed' | 'watch_value_changed';
+export interface DebuggerEvent {
+    type: DebuggerEventType;
+    graphId?: string;
+    nodeId?: string;
+    data?: unknown;
+}
+export type DebuggerEventHandler = (event: DebuggerEvent) => void;
+export interface WatchExpression {
+    id: string;
+    expression: string;
+    name?: string;
+    currentValue?: unknown;
+    lastError?: string;
+}
+export interface CallStackFrame {
+    graphId: string;
+    nodeId: string;
+    nodeName: string;
+    nodeType: string;
+    timestamp: number;
+}
+export declare class VisualScriptDebugger {
+    /** Debugger state */
+    private state;
+    /** Breakpoints by graph ID */
+    private breakpoints;
+    /** Conditional breakpoints */
+    private conditionalBreakpoints;
+    /** Watch expressions */
+    private watches;
+    /** Call stack */
+    private callStack;
+    /** Variable history (for undo/logging) */
+    private variableHistory;
+    /** Event handlers */
+    private eventHandlers;
+    /** Hit counts for breakpoints */
+    private hitCounts;
+    /** Skip counts for breakpoints */
+    private skipCounts;
+    /** Current node being debugged */
+    private currentNode;
+    /** Current graph being debugged */
+    private currentGraph;
+    constructor();
+    /** Get current debugger state */
+    getState(): DebuggerState;
+    /** Set debugger mode */
+    setMode(mode: DebuggerMode): void;
+    /** Enable debugger */
+    enable(): void;
+    /** Disable debugger */
+    disable(): void;
+    /** Check if debugger is active */
+    isActive(): boolean;
+    /** Check if paused */
+    isPaused(): boolean;
+    /** Pause execution */
+    pause(): void;
+    /** Resume execution */
+    resume(): void;
+    /** Step into next node */
+    stepInto(): void;
+    /** Step over (complete current node) */
+    stepOver(): void;
+    /** Step out (complete current execution path) */
+    stepOut(): void;
+    /** Check if should break at node */
+    shouldBreak(graphId: string, nodeId: string): boolean;
+    /** Add breakpoint */
+    addBreakpoint(graphId: string, nodeId: string, condition?: string): Breakpoint;
+    /** Remove breakpoint */
+    removeBreakpoint(graphId: string, nodeId: string): void;
+    /** Toggle breakpoint */
+    toggleBreakpoint(graphId: string, nodeId: string): boolean;
+    /** Check if breakpoint exists */
+    hasBreakpoint(graphId: string, nodeId: string): boolean;
+    /** Get all breakpoints */
+    getBreakpoints(): Breakpoint[];
+    /** Set skip count for breakpoint */
+    setBreakpointSkipCount(graphId: string, nodeId: string, count: number): void;
+    /** Clear all breakpoints */
+    clearAllBreakpoints(): void;
+    /** Add watch expression */
+    addWatch(expression: string, name?: string): WatchExpression;
+    /** Remove watch */
+    removeWatch(id: string): void;
+    /** Update watch value */
+    updateWatch(id: string, value: unknown): void;
+    /** Evaluate watch expressions with context */
+    evaluateWatches(context: Map<string, unknown>): void;
+    /** Get all watches */
+    getWatches(): WatchExpression[];
+    /** Push frame to call stack */
+    pushCallStack(frame: CallStackFrame): void;
+    /** Pop frame from call stack */
+    popCallStack(): CallStackFrame | undefined;
+    /** Get call stack */
+    getCallStack(): CallStackFrame[];
+    /** Clear call stack */
+    clearCallStack(): void;
+    /** Called when node execution starts */
+    onNodeEnter(graphId: string, nodeId: string): void;
+    /** Called when node execution ends */
+    onNodeExit(graphId: string, nodeId: string): void;
+    /** Called when an error occurs */
+    onError(graphId: string, nodeId: string, error: Error): void;
+    /** Called when a variable changes */
+    onVariableChange(graphId: string, name: string, oldValue: unknown, newValue: unknown): void;
+    /** Get variable history */
+    getVariableHistory(name: string): Array<{
+        value: unknown;
+        timestamp: number;
+    }>;
+    /** Add event handler */
+    addEventListener(handler: DebuggerEventHandler): void;
+    /** Remove event handler */
+    removeEventListener(handler: DebuggerEventHandler): void;
+    /** Emit event */
+    private emit;
+    /** Reset debugger state */
+    reset(): void;
+    /** Get debug info for a node */
+    getNodeDebugInfo(graphId: string, nodeId: string): NodeDebugInfo;
+    /** Serialize debugger state */
+    serialize(): SerializedDebuggerState;
+    /** Deserialize debugger state */
+    deserialize(data: SerializedDebuggerState): void;
+}
+export interface NodeDebugInfo {
+    isBreakpoint: boolean;
+    isCurrent: boolean;
+    hitCount: number;
+}
+export interface SerializedDebuggerState {
+    mode: DebuggerMode;
+    breakpoints: Breakpoint[];
+    watches: Array<{
+        expression: string;
+        name?: string;
+    }>;
+}
+export declare function createDebugger(): VisualScriptDebugger;