@nice2dev/game-engine 1.0.2 → 1.0.3

package/dist/types/import/UnitySceneImporter.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @file UnitySceneImporter.ts
+ * @description Import Unity scenes (.unity) and prefabs (.prefab)
+ * PRO-1.3: Scene Format Interoperability
+ *
+ * Parses Unity's YAML serialization format and converts to Nice2Dev entities.
+ * Supports:
+ * - Scene files (.unity)
+ * - Prefab files (.prefab)
+ * - Asset files (.asset)
+ * - Animation clips (.anim)
+ * - Materials (.mat)
+ */
+import { SceneImporter, ImportOptions, ImportResult, ParsedScene, ParsedComponent, ParsedAsset, ImportError } from './SceneImporter';
+interface UnityTransform {
+    m_LocalRotation: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    m_LocalPosition: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    m_LocalScale: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    m_Children?: {
+        fileID: number;
+    }[];
+    m_Father?: {
+        fileID: number;
+    };
+    m_RootOrder?: number;
+}
+export declare class UnitySceneImporter extends SceneImporter {
+    private documents;
+    private gameObjects;
+    private transforms;
+    private components;
+    private prefabs;
+    constructor();
+    import(options: ImportOptions): Promise<ImportResult>;
+    parseFile(content: string | ArrayBuffer, filePath: string): Promise<ParsedScene | ParsedAsset | null>;
+    validate(sourcePath: string): Promise<ImportError[]>;
+    private parseUnityFile;
+    private parseUnityYAML;
+    private buildSceneFromDocuments;
+    private buildEntityFromTransform;
+    private getComponentsForGameObject;
+    private convertUnityComponent;
+    private extractSceneSettings;
+    private extractAssets;
+    private extractSpriteReferences;
+    private extractAudioReferences;
+    private extractAnimationReferences;
+    private quaternionToEulerY;
+    private readFile;
+    /** Convert Unity RectTransform to Nice2Dev format */
+    protected convertRectTransform(transform: UnityTransform & {
+        m_AnchorMin?: {
+            x: number;
+            y: number;
+        };
+        m_AnchorMax?: {
+            x: number;
+            y: number;
+        };
+        m_AnchoredPosition?: {
+            x: number;
+            y: number;
+        };
+        m_SizeDelta?: {
+            x: number;
+            y: number;
+        };
+        m_Pivot?: {
+            x: number;
+            y: number;
+        };
+    }): ParsedComponent;
+}
+export {};

package/dist/types/import/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @file index.ts
+ * @description Scene Format Import Module Exports
+ * PRO-1.3: Scene Format Interoperability
+ */
+export { SceneImporter, IMPORT_SOURCES, parseYAML, parseXML, detectSourceType, getAvailableImporters, hasImporter, } from './SceneImporter';
+export type { ImportSourceType, ImportSourceInfo, ImportOptions, ImportResult, ImportError, ImportWarning, ImportStatistics, ParsedScene, ParsedLayer, ParsedEntity, ParsedComponent, ParsedTileData, ParsedTileset, ParsedTileInfo, ParsedAnimation, ParsedAnimationFrame, ParsedAsset, ParsedSpriteSheet, XMLNode, } from './SceneImporter';
+export { UnitySceneImporter } from './UnitySceneImporter';
+export { GodotSceneImporter } from './GodotSceneImporter';
+export { TiledMapImporter } from './TiledMapImporter';
+export { LDtkImporter } from './LDtkImporter';
+export { AsepriteImporter } from './AsepriteImporter';
+export { OgmoImporter, createOgmoImporter } from './OgmoImporter';
+export type { OgmoProject, OgmoLevel, OgmoLayerDef, OgmoEntityDef, OgmoTilesetDef, OgmoLayerInstance, OgmoEntityInstance, OgmoDecalInstance, } from './OgmoImporter';
+export { RPGMakerImporter, createRPGMakerImporter } from './RPGMakerImporter';
+export type { RPGMakerMap, RPGMakerEvent, RPGMakerEventPage, RPGMakerCommand, RPGMakerMoveRoute, RPGMakerMoveCommand, RPGMakerTileset, } from './RPGMakerImporter';
+export { GameMakerImporter, createGameMakerImporter } from './GameMakerImporter';
+export type { GMRoom, GMLayerInstance, GMRoomInstance, GMTileLayer, GMBackgroundLayer, GMAssetLayer, } from './GameMakerImporter';
+export { SpineImporter, createSpineImporter } from './SpineImporter';
+export type { SpineSkeletonData, SpineBone, SpineSlot, SpineSkin, SpineAttachment, SpineRegionAttachment, SpineMeshAttachment, SpinePointAttachment, SpinePathAttachment, SpineClippingAttachment, SpineEvent, SpineAnimation, } from './SpineImporter';
+export { DragonBonesImporter, createDragonBonesImporter } from './DragonBonesImporter';
+export type { DBSkeletonData, DBArmature, DBBone, DBSlot, DBSkin, DBDisplay, DBImageDisplay, DBMeshDisplay, DBArmatureDisplay, DBBoundingBoxDisplay, DBPathDisplay, DBAnimation, DBTextureAtlas, } from './DragonBonesImporter';
+export { Live2DImporter, createLive2DImporter } from './Live2DImporter';
+export type { L2DModelSettings, L2DFileReferences, L2DExpressionRef, L2DMotionRef, L2DGroup, L2DHitArea, L2DPhysics, L2DPhysicsSetting, L2DPose, L2DExpression, L2DMotion, L2DMotionCurve, L2DDisplayInfo, } from './Live2DImporter';
+export { SpriterImporter, createSpriterImporter } from './SpriterImporter';
+export type { SpriterProject, SpriterData, SpriterFolder, SpriterFile, SpriterEntity, SpriterAnimation, SpriterMainline, SpriterTimeline, SpriterTimelineKey, SpriterBone, SpriterObject, SpriterCharacterMap, } from './SpriterImporter';
+export { NdgImporter, NdgExporter, NdgBidirectionalSync, createNdgImporter, createNdgExporter, createBidirectionalSync, sceneToNdg, ndgToScene, } from './NdgFormat';
+export type { NdgFile, NdgGenerator, NdgSource, NdgProject, NdgProjectSettings, NdgPhysicsSettings, NdgAudioSettings, NdgRenderingSettings, NdgInputSettings, NdgInputAction, NdgScene, NdgSceneSettings, NdgCameraSettings, NdgLightingSettings, NdgLayerDef, NdgEntity, NdgTransform, NdgComponent, NdgPrefabRef, NdgPrefabOverride, NdgScript, NdgScriptRef, NdgTilemap, NdgTilemapLayer, NdgAsset, NdgAssetImportSettings, NdgAssetBundle, } from './NdgFormat';
+import { SceneImporter, ImportSourceType } from './SceneImporter';
+import { NdgImporter } from './NdgFormat';
+/**
+ * Create an importer for the specified source type
+ */
+export declare function createImporter(sourceType: ImportSourceType | string): SceneImporter;
+/**
+ * Create importer for NDG native format
+ */
+export declare function createNativeImporter(): NdgImporter;
+/**
+ * Get importer for file based on extension
+ */
+export declare function getImporterForFile(filePath: string): SceneImporter | null;
+/**
+ * Check if a file can be imported
+ */
+export declare function canImport(filePath: string): boolean;
+/**
+ * Get all supported file extensions
+ */
+export declare function getSupportedExtensions(): string[];
+/**
+ * Get supported formats info
+ */
+export declare function getSupportedFormats(): Array<{
+    name: string;
+    type: ImportSourceType | string;
+    extensions: string[];
+    description: string;
+}>;

package/dist/types/index.d.ts

@@ -5,10 +5,10 @@ export { GameConfig } from './core/GameConfig';
 export { EventBus } from './core/EventBus';
 export { ServiceLocator, SERVICE_KEYS } from './core/ServiceLocator';
 export { v2 } from './core/math';
-export { World, System, createDefaultComponent, } from './ecs/World';
+export { World, System, createDefaultComponent } from './ecs/World';
 export type { Entity, ComponentMap, BuiltInComponent, TransformComponent, SpriteComponent, ShapeComponent, Collider2DComponent, RigidBody2DComponent, TextComponent, AnimatorComponent, ScriptComponent, AudioSourceComponent, ParticleEmitterComponent, CameraTargetComponent, SpriteAnimation, AnimationFrame, } from './ecs/World';
-export { InputManager, PRESET_PLATFORMER, PRESET_TOPDOWN, PRESET_TWIN_STICK } from './input/InputManager';
-export { GamepadNavigationProvider as NiceGamepadNavigationProvider, GamepadNavigationProvider, useGamepadNavigation } from './input/GamepadNavigation';
+export { InputManager, PRESET_PLATFORMER, PRESET_TOPDOWN, PRESET_TWIN_STICK, } from './input/InputManager';
+export { GamepadNavigationProvider as NiceGamepadNavigationProvider, GamepadNavigationProvider, useGamepadNavigation, } from './input/GamepadNavigation';
 export type { FocusableMeta, GamepadNavigationContextType } from './input/GamepadNavigation';
 export { useGamepads, useGamepadEdges } from './input/useGamepads';
 export type { GamepadSnapshot } from './input/useGamepads';
@@ -24,20 +24,20 @@ export { PlayerManager, SplitScreenManager, PLAYER_COLORS } from './multiplayer/
 export type { Player, Viewport } from './multiplayer/LocalMultiplayer';
 export { GameRegistry, gameRegistry, MINI_PLAYER_COLORS, MINI_PLAYER_NAMES, KEYBOARD_GROUPS, DIR_UP, DIR_DOWN, DIR_LEFT, DIR_RIGHT, } from './multiplayer/MiniGameTypes';
 export type { PlayerSlot, InputSource, Dir, KeyboardGroup, MiniGameMeta, MiniGameConfig, } from './multiplayer/MiniGameTypes';
-export { SeededRandom, PerlinNoise, WaveGenerator, LootTable as ProceduralLootTable, ProceduralSprite } from './procedural/Procedural';
+export { SeededRandom, PerlinNoise, WaveGenerator, LootTable as ProceduralLootTable, ProceduralSprite, } from './procedural/Procedural';
 export type { WaveEntry, WaveConfig, LootDrop } from './procedural/Procedural';
 export { NiceGameEngine } from './engine/NiceGameEngine';
 export type { EngineOptions } from './engine/NiceGameEngine';
 export { WaveDefenseTemplate, DEFAULT_WAVE_DEFENSE_CONFIG } from './templates/WaveDefense';
-export type { WaveDefenseConfig, WaveDefenseState, UpgradeDef, UpgradeEffect } from './templates/WaveDefense';
-export { NiceGameEditor, UndoStack, useEditor, serializeProject, deserializeProject } from './editor/NiceGameEditor';
-export type { NiceGameEditorProps, EditorContextValue, EditorState, EditorTool, EditorMode, EditorPanel, UndoEntry } from './editor/NiceGameEditor';
+export type { WaveDefenseConfig, WaveDefenseState, UpgradeDef, UpgradeEffect, } from './templates/WaveDefense';
+export { NiceGameEditor, UndoStack, useEditor, serializeProject, deserializeProject, } from './editor/NiceGameEditor';
+export type { NiceGameEditorProps, EditorContextValue, EditorState, EditorTool, EditorMode, EditorPanel, UndoEntry, } from './editor/NiceGameEditor';
 export { createGizmoState, getSelectionRect, entitiesInRect, snapToGrid, snapVec2ToGrid, renderGrid, renderTranslateGizmo, renderRotateGizmo, renderScaleGizmo, hitTestGizmoAxis, pickEntityAt, copyEntities, pasteEntities, } from './editor/SceneEditor';
-export type { GizmoMode, GizmoAxis, GizmoState, SelectionBox, ClipboardEntry } from './editor/SceneEditor';
+export type { GizmoMode, GizmoAxis, GizmoState, SelectionBox, ClipboardEntry, } from './editor/SceneEditor';
 export { AssetManager } from './editor/AssetManager';
 export type { AssetMetadata, AssetFolder } from './editor/AssetManager';
-export { Profiler, FPSCounter, ConsoleLogger, snapshotEntity, snapshotWorld, renderCollisionDebug, getMemoryStats } from './editor/DebugTools';
-export type { ProfilerSample, ProfilerFrame, LogLevel, LogEntry, EntitySnapshot, MemoryStats } from './editor/DebugTools';
+export { Profiler, FPSCounter, ConsoleLogger, snapshotEntity, snapshotWorld, renderCollisionDebug, getMemoryStats, } from './editor/DebugTools';
+export type { ProfilerSample, ProfilerFrame, LogLevel, LogEntry, EntitySnapshot, MemoryStats, } from './editor/DebugTools';
 export { NodeLibrary, GraphExecutor, registerBuiltInNodes, createDefaultNodeLibrary, } from './scripting/NodeGraph';
 export type { PortDataType, PortDef, NodeDef, NodeInstance, Connection, ScriptGraph, GraphVariable, } from './scripting/NodeGraph';
 export { Tilemap, computeAutoTileMask } from './tilemap/Tilemap';
@@ -49,7 +49,7 @@ export type { PathGrid, PathfinderOptions, NavPolygon, NavMesh } from './pathfin
 export { PeerManager, createWebSocketSignaling, NetworkManager, SnapshotBuffer, ClientPrediction, interpolateState, LobbyManager, } from './network/Networking';
 export type { ConnectionState, PeerInfo, SignalingMessage, SignalingTransport, RTCConfig, NetworkMode, NetworkIdentity, RPCDef, SyncVarDef, NetworkMessage, Snapshot, EntityState, PredictionInput, LobbyRoom, LobbyPlayer, } from './network/Networking';
 export { LocalTransport, SignalRTransport } from './network/MultiplayerTransport';
-export type { IMultiplayerTransport, TransportState, TransportMessage } from './network/MultiplayerTransport';
+export type { IMultiplayerTransport, TransportState, TransportMessage, } from './network/MultiplayerTransport';
 export { v3, quat, World3D, PhysicsWorld3D, Renderer3D, createDefaultCamera3DSettings, updateOrbitCamera, updateCharacterController, DEFAULT_CHARACTER_CONFIG, } from './runtime3d/Runtime3D';
 export type { Vec3 as Vec3_3D, Quaternion, Transform3D, MeshPrimitive, MeshComponent, LightType, LightComponent, CameraMode3D, Camera3DComponent, Material3D, CameraController, Camera3DSettings, ColliderShape3D, RigidBodyType3D, Collider3DDef, RigidBody3DDef, PhysicsWorld3DConfig, PhysicsBackend3D, RaycastHit3D, RendererBackend3D, CharacterControllerConfig, CharacterState, } from './runtime3d/Runtime3D';
 export { createGizmo3DState, snapToGrid3D, placeObject, Terrain3D, MaterialLibrary, createBlendTree, addBlendTreeChild, evaluateBlendTree, DEFAULT_PLACEMENT_CONFIG, DEFAULT_TERRAIN_CONFIG, DEFAULT_SKYBOX, DEFAULT_FPS_CONFIG, DEFAULT_THIRD_PERSON_CONFIG, DEFAULT_RACING_3D_CONFIG, DEFAULT_FLIGHT_SIM_CONFIG, DEFAULT_HORROR_CONFIG, } from './runtime3d/SceneEditor3D';
@@ -96,7 +96,7 @@ export { DEFAULT_BRANDING, generateCSSVariables, DEFAULT_PASSWORD_POLICY, valida
 export type { BrandingConfig, AuthProvider, AuthConfig, AuthProviderConfig, MFAConfig, PasswordPolicy, Permission, RoleDef, AuditAction, AuditEntry, AuditQuery, Organization, OrgMember, OrgPlan, OrgSettings, APIKey, RateLimitConfig, DeploymentConfig, DatabaseConfig, StorageConfig, CacheConfig, ScalingConfig, } from './enterprise/Enterprise';
 export { I18nManager, getI18n, initI18n, t, registerEngineTranslations, ENGINE_TRANSLATIONS_EN, ENGINE_TRANSLATIONS_PL, ENGINE_TRANSLATIONS_DE, SUPPORTED_LOCALES, LOCALE_NAMES, RTL_LOCALES, } from './i18n/I18n';
 export type { Locale, TranslationDict, TranslationNamespace, InterpolationValues, PluralCategory, PluralRule, I18nConfig, } from './i18n/I18n';
-export { useTranslation, I18nProvider, TranslatedText, LocaleSelect, } from './i18n/useTranslation';
+export { useTranslation, I18nProvider, TranslatedText, LocaleSelect } from './i18n/useTranslation';
 export type { UseTranslationResult } from './i18n/useTranslation';
 export { TutorialEngine, getBuiltInTutorials, TUTORIAL_FIRST_GAME, TUTORIAL_SPACE_SHOOTER, TUTORIAL_DATAGRID_BASICS, } from './tutorials/TutorialEngine';
 export type { TutorialStepType, TutorialDifficulty, TutorialCategory, QuizOption, CodeValidation, TutorialStep, TutorialDefinition, TutorialProgress, TutorialEvents, CodeValidatorFn, } from './tutorials/TutorialEngine';
@@ -107,7 +107,7 @@ export type { EngineError, APIHint, PerfSnapshot, PerfDashboard, HealthCheckResu
 export { TUTORIAL_ANIMATIONS, TUTORIAL_TILEMAPS, TUTORIAL_VISUAL_SCRIPTING, TUTORIAL_LOCAL_MULTIPLAYER, getTutorials_T05_T08, } from './tutorials/content/Tutorials_T05_T08';
 export { clamp, clampPositive, assertFinite, assertPositive, assertNonNegative, assertInRange, assertNonEmpty, assertCanvasElement, validateGameSettings, validatePhysicsSettings, } from './core/Validation';
 export type { ValidationResult } from './core/Validation';
-export { PluginManager, PluginMarketplace, PLUGIN_TEMPLATES, } from './plugins/PluginSDK';
+export { PluginManager, PluginMarketplace, PLUGIN_TEMPLATES } from './plugins/PluginSDK';
 export type { PluginState as SDKPluginState, PluginType, PluginManifest as SDKPluginManifest, PluginContext, PluginDefinition, ExtensionPoint, PluginStorage, PluginInstance as SDKPluginInstance, PluginTemplate, MarketplaceEntry, MarketplaceSearchResult, } from './plugins/PluginSDK';
 export { TestPluginStorage, TestPluginContext, PluginAssertionError, pluginAssert, PluginTestRunner, createTestManifest, testPluginLifecycle, formatTestResults, } from './plugins/PluginTestKit';
 export type { TestStatus, TestResult, TestSuiteResult, PluginTestCase, } from './plugins/PluginTestKit';
@@ -116,16 +116,16 @@ export { TUTORIAL_RPG, TUTORIAL_TOWER_DEFENSE, TUTORIAL_3D_GAME, TUTORIAL_PUBLIS
 export { FrameBudgetManager, MemoryLeakDetector, AutoLODManager, WorkerPool, PerfTimer, ObjectPool as LegendaryObjectPool, QUALITY_PRESETS, } from './performance/PerformanceAdvanced';
 export type { FrameBudgetConfig, BudgetReport, FrameBudgetSnapshot, MemoryTracker, MemorySnapshot, LeakSuspect, QualityLevel, AutoLODConfig, QualitySettings, WorkerTaskStatus, WorkerTask, WorkerPoolConfig, } from './performance/PerformanceAdvanced';
 export { TutorialOverlay } from './tutorials/TutorialOverlay';
-export type { OverlayConfig, TooltipPosition, OverlayAction, } from './tutorials/TutorialOverlay';
-export { DocRegistry, DOCS_ECS, DOCS_RENDERING, } from './docs/DocGenerator';
+export type { OverlayConfig, TooltipPosition, OverlayAction } from './tutorials/TutorialOverlay';
+export { DocRegistry, DOCS_ECS, DOCS_RENDERING } from './docs/DocGenerator';
 export type { DocCategory, DocMemberKind, DocParam, DocMember, DocModule, DocSearchResult, } from './docs/DocGenerator';
 export { BranchingEngine, AchievementEngine, BUILT_IN_ACHIEVEMENTS, } from './tutorials/TutorialBranching';
 export type { BranchConditionType, BranchCondition, BranchRule, BranchingStep, BranchingConfig, BranchContext, AchievementTier, AchievementCondition, AchievementDefinition, AchievementProgress as LegendaryAchievementProgress, } from './tutorials/TutorialBranching';
 export { HotModuleReplacer, AssetPipeline, DeployManager, CollaborationManager, } from './devtools/DevTools';
 export type { HMRModule, HMRUpdate, AssetType as PipelineAssetType, AssetMeta, AssetProcessorOptions, DeployTarget, DeployConfig, DeployResult, CollaboratorCursor, } from './devtools/DevTools';
-export { GuidedWizard, BlockEditor, KID_BLOCK_PALETTES, } from './kids/KidTools';
+export { GuidedWizard, BlockEditor, KID_BLOCK_PALETTES } from './kids/KidTools';
 export type { WizardChoice, WizardStep, WizardResult, BlockShape, DragBlock, BlockPalette, DragDropState, } from './kids/KidTools';
-export { BenchmarkRunner, BUILTIN_BENCHMARKS, } from './performance/BenchmarkSuite';
+export { BenchmarkRunner, BUILTIN_BENCHMARKS } from './performance/BenchmarkSuite';
 export type { BenchmarkScenario, BenchmarkTimings, BenchmarkMemory, BenchmarkResult as BenchmarkScenarioResult, BenchmarkReport, RegressionResult, } from './performance/BenchmarkSuite';
 export { iconToSvgString, svgToDataUrl, loadSvgImage, rasterizeSvg, getIconTextureId, registerIconTexture, registerIconCanvasTexture, createIconEntity, createIconAnimationClip, CHARACTER_ANIMATION_STATES, OBJECT_ANIMATION_STATES, registerIconAnimationSet, createIconAnimator, registerIconCatalog, } from './integration/IconSprite';
 export type { IconComponent, IconComponentProps, IconSpriteOptions, IconEntityOptions, IconAnimationFrame, IconAnimationSheetOptions, IconCatalogEntry, } from './integration/IconSprite';
@@ -141,3 +141,15 @@ export { compressSaveData, decompressSaveData, crc32, MigrationEngine, SaveSyste
 export type { SaveSlotType, SaveConflictStrategy, SaveStorageBackend, MigrationDirection, SaveSlotMeta, SaveData, SaveMigration, CloudSyncConfig, AutoSaveConfig, SaveSystemConfig, SaveConflict, SaveResult, } from './engine/SaveSystemV2';
 export { TelemetryPipeline, HeatmapGenerator, SessionRecorder, SessionPlayer, FunnelTracker, GameplayAnalytics, useGameplayAnalytics, AnalyticsDashboard, DEFAULT_TELEMETRY_CONFIG, DEFAULT_HEATMAP_CONFIG, DEFAULT_RECORDING_CONFIG, } from './devtools/GameplayAnalytics';
 export type { TelemetryEventCategory, HeatmapType, SessionEventType, TelemetryEvent, TelemetryConfig, HeatmapConfig, HeatmapCell, SessionFrame, SessionRecordedEvent, SessionRecording, SessionRecordingConfig, FunnelStep, FunnelDefinition, AnalyticsDashboardProps, } from './devtools/GameplayAnalytics';
+export * from './scripting/ScriptAST';
+export { type ExportConfig as ScriptExportConfig, defaultConfig, type ExportedFile as ScriptExportedFile, type ExportResult as ScriptExportResult, type ExportError as ScriptExportError, type ExportWarning as ScriptExportWarning, type TypeMapping, CodeBuilder, LanguageExporter, ImperativeLanguageExporter, escapeString, toUpperCamelCase, toLowerCamelCase, toSnakeCase, toScreamingSnakeCase, } from './scripting/LanguageExporter';
+export * from './scripting/GraphToAST';
+export { CSharpExporter, GDScriptExporter, LuaExporter, PythonExporter, RustExporter, TypeScriptExporter, } from './scripting/exporters';
+export * from './export';
+export * from './import';
+export * from './editor/TimelineEditor';
+export * from './editor/ShaderGraph';
+export * from './systems/ParticleSystem2';
+export * from './ai/BehaviorTree';
+export * from './ai/StateMachine';
+export * from './scripting/VisualScripting2';

package/dist/types/scripting/GraphToAST.d.ts

@@ -0,0 +1,55 @@
+import type { ScriptGraph } from './NodeGraph';
+import { NodeLibrary } from './NodeGraph';
+import type { ASTScript } from './ScriptAST';
+export interface ConvertOptions {
+    /** Name for the generated class */
+    className?: string;
+    /** Base class to extend */
+    baseClass?: string;
+    /** Whether to generate async methods for delay/wait nodes */
+    useAsync?: boolean;
+    /** Whether to generate comments showing node IDs */
+    includeNodeIds?: boolean;
+    /** Prefix for generated variable names */
+    varPrefix?: string;
+}
+export declare class GraphToAST {
+    private library;
+    constructor(library?: NodeLibrary);
+    /**
+     * Convert a visual script graph to AST representation.
+     */
+    convert(graph: ScriptGraph, options?: ConvertOptions): ASTScript;
+    /**
+     * Convert multiple graphs into a single script module.
+     */
+    convertMultiple(graphs: ScriptGraph[], moduleName: string, options?: ConvertOptions): ASTScript;
+    private findEntryNodes;
+    private entryTypeToMethodName;
+    private convertVariables;
+    private valueToASTType;
+    private convertEntryPointsToMethod;
+    private getEntryParams;
+    private createEmptyMethod;
+    private processNode;
+    private generateNodeCode;
+    private generateFlowNode;
+    private generateIfElse;
+    private generateDelay;
+    private generateForLoop;
+    private generateWhileLoop;
+    private generateMathNode;
+    private generateLogicNode;
+    private generateVariableNode;
+    private generateEntityNode;
+    private generateInputNode;
+    private generateAudioNode;
+    private generateGenericNode;
+    private resolveInputExpression;
+    private valueToExpression;
+    private getOrCreateNodeVar;
+    private getFlowTargetNodes;
+    private followFlowConnections;
+}
+export declare function convertGraphToAST(graph: ScriptGraph, library: NodeLibrary, options?: ConvertOptions): ASTScript;
+export default GraphToAST;

package/dist/types/scripting/LanguageExporter.d.ts

@@ -0,0 +1,136 @@
+import type { ASTScript, ASTClass, ASTFunction, ASTField, ASTProperty, ASTStatement, ASTExpression, ASTTypeInfo, ASTVarDecl, ASTAssignment, ASTIf, ASTWhile, ASTFor, ASTForEach, ASTReturn, ASTSwitch, ASTTry, ASTLiteral, ASTBinaryOp, ASTUnaryOp, ASTCall, ASTMethodCall, ASTPropertyAccess, ASTIndexAccess, ASTConditional, ASTArrayLiteral, ASTDictionaryLiteral, ASTCast, ASTLambda, ASTNew, ASTImport, ASTEnum, ASTSignalDef } from './ScriptAST';
+export interface ExportConfig {
+    /** Target game engine/platform */
+    targetEngine?: 'unity' | 'godot' | 'bevy' | 'pygame' | 'love2d' | 'defold' | 'generic';
+    /** Engine version (e.g., '4.2' for Godot) */
+    engineVersion?: string;
+    /** Indentation string */
+    indent: string;
+    /** Line ending */
+    lineEnding: '\n' | '\r\n';
+    /** Whether to include debug comments */
+    includeDebugComments: boolean;
+    /** Include source node IDs in comments */
+    includeSourceMappings: boolean;
+    /** Base class name for generated scripts */
+    baseClassName?: string;
+    /** Namespace/package for generated code */
+    namespace?: string;
+    /** Additional custom options */
+    custom?: Record<string, unknown>;
+}
+export declare const defaultConfig: ExportConfig;
+export interface ExportedFile {
+    filename: string;
+    content: string;
+    /** Language/file type */
+    language: string;
+    /** Optional file path for export consumption */
+    path?: string;
+}
+export interface ExportResult {
+    files: ExportedFile[];
+    errors: ExportError[];
+    warnings: ExportWarning[];
+    stats: {
+        classCount: number;
+        methodCount: number;
+        lineCount: number;
+        exportDuration: number;
+    };
+}
+export interface ExportError {
+    message: string;
+    nodeId?: string;
+    line?: number;
+    column?: number;
+}
+export interface ExportWarning {
+    message: string;
+    nodeId?: string;
+    suggestion?: string;
+}
+export interface TypeMapping {
+    [key: string]: string;
+}
+export declare class CodeBuilder {
+    private lines;
+    private currentIndent;
+    private indentStr;
+    private lineEnding;
+    constructor(config: ExportConfig);
+    indent(): this;
+    dedent(): this;
+    line(text?: string): this;
+    rawLine(text: string): this;
+    emptyLine(): this;
+    comment(text: string, style?: 'line' | 'block'): this;
+    docComment(text: string, style?: 'csharp' | 'jsdoc' | 'python' | 'lua'): this;
+    block(open: string, close: string, body: () => void): this;
+    toString(): string;
+    get lineCount(): number;
+}
+export declare abstract class LanguageExporter {
+    protected config: ExportConfig;
+    protected errors: ExportError[];
+    protected warnings: ExportWarning[];
+    /** Language name for identification */
+    abstract readonly languageName: string;
+    /** File extension without dot */
+    abstract readonly fileExtension: string;
+    /** Type mapping from AST types to target language */
+    abstract readonly typeMapping: TypeMapping;
+    constructor(config?: Partial<ExportConfig>);
+    export(script: ASTScript, config?: Partial<ExportConfig>): ExportResult;
+    protected addError(message: string, nodeId?: string): void;
+    protected addWarning(message: string, nodeId?: string, suggestion?: string): void;
+    protected mapType(typeInfo: ASTTypeInfo): string;
+    protected createBuilder(): CodeBuilder;
+    protected abstract generateScript(script: ASTScript): string;
+    protected abstract generateClass(cls: ASTClass, builder: CodeBuilder): void;
+    protected abstract generateMethod(method: ASTFunction, builder: CodeBuilder): void;
+    protected abstract generateField(field: ASTField, builder: CodeBuilder): void;
+    protected abstract generateStatement(stmt: ASTStatement, builder: CodeBuilder): void;
+    protected abstract generateExpression(expr: ASTExpression): string;
+    protected formatArrayType(elementType: string): string;
+    protected formatDictType(keyType: string, valueType: string): string;
+    protected formatNullableType(baseType: string): string;
+    protected generateImport(_imp: ASTImport, _builder: CodeBuilder): void;
+    protected generateEnum(_en: ASTEnum, _builder: CodeBuilder): void;
+    protected generateProperty(_prop: ASTProperty, _builder: CodeBuilder): void;
+    protected generateSignal(_signal: ASTSignalDef, _builder: CodeBuilder): void;
+}
+export declare abstract class ImperativeLanguageExporter extends LanguageExporter {
+    protected generateStatement(stmt: ASTStatement, builder: CodeBuilder): void;
+    protected generateExpression(expr: ASTExpression): string;
+    protected abstract readonly statementTerminator: string;
+    protected abstract readonly breakKeyword: string;
+    protected abstract readonly continueKeyword: string;
+    protected abstract generateVarDecl(decl: ASTVarDecl, builder: CodeBuilder): void;
+    protected abstract generateAssignment(assign: ASTAssignment, builder: CodeBuilder): void;
+    protected abstract generateIf(stmt: ASTIf, builder: CodeBuilder): void;
+    protected abstract generateWhile(stmt: ASTWhile, builder: CodeBuilder): void;
+    protected abstract generateFor(stmt: ASTFor, builder: CodeBuilder): void;
+    protected abstract generateForEach(stmt: ASTForEach, builder: CodeBuilder): void;
+    protected abstract generateReturn(stmt: ASTReturn, builder: CodeBuilder): void;
+    protected abstract generateSwitch(stmt: ASTSwitch, builder: CodeBuilder): void;
+    protected abstract generateTry(stmt: ASTTry, builder: CodeBuilder): void;
+    protected abstract generateLiteral(lit: ASTLiteral): string;
+    protected abstract generateBinaryOp(op: ASTBinaryOp): string;
+    protected abstract generateUnaryOp(op: ASTUnaryOp): string;
+    protected abstract generateCall(call: ASTCall): string;
+    protected abstract generateMethodCall(call: ASTMethodCall): string;
+    protected abstract generatePropertyAccess(access: ASTPropertyAccess): string;
+    protected abstract generateIndexAccess(access: ASTIndexAccess): string;
+    protected abstract generateConditional(cond: ASTConditional): string;
+    protected abstract generateArrayLiteral(arr: ASTArrayLiteral): string;
+    protected abstract generateDictionaryLiteral(dict: ASTDictionaryLiteral): string;
+    protected abstract generateCast(cast: ASTCast): string;
+    protected abstract generateLambda(lambda: ASTLambda): string;
+    protected abstract generateNew(n: ASTNew): string;
+}
+export declare function escapeString(str: string, quote?: '"' | "'"): string;
+export declare function toUpperCamelCase(str: string): string;
+export declare function toLowerCamelCase(str: string): string;
+export declare function toSnakeCase(str: string): string;
+export declare function toScreamingSnakeCase(str: string): string;