@nice2dev/game-engine 0.1.0 → 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, 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';
@@ -18,26 +18,26 @@ export { Renderer2D, RenderSystem } from './rendering/Renderer2D';
 export { PhysicsEngine2D, PhysicsSystem } from './physics/PhysicsEngine2D';
 export { SceneManager } from './scene/SceneManager';
 export type { SceneConfig, SceneTransition, TransitionType, PrefabDef } from './scene/SceneManager';
-export { GameUI } from './ui/GameUI';
+export { GameUI as NiceGameUI, GameUI } from './ui/GameUI';
 export type { UIElement, UIStyle, UITheme, UIAnchor, UIElementType } from './ui/GameUI';
 export { PlayerManager, SplitScreenManager, PLAYER_COLORS } from './multiplayer/LocalMultiplayer';
 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, 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';
@@ -60,6 +60,8 @@ export { DEFAULT_MATCH3_CONFIG, createMatch3Board, findMatches, removeMatches, a
 export type { Match3Config, GemType, Match3Board, BlockPuzzleConfig, BlockPuzzleState, PhysicsPuzzleConfig, PuzzleLevelDef, HiddenObjectConfig, HiddenObjectDef, HiddenObjectLevel, CardDef, DeckConfig, } from './templates/PuzzleTemplates';
 export { DEFAULT_RPG_CONFIG, xpForLevel, createInventory, addItem, DEFAULT_VISUAL_NOVEL_CONFIG, parseVNLabels, createVNState, DEFAULT_POINT_AND_CLICK_CONFIG, DEFAULT_ROGUELIKE_CONFIG, generateDungeon, computeFOV, DEFAULT_DUNGEON_CRAWLER_CONFIG, } from './templates/RPGTemplates';
 export type { RPGConfig, RPGStats, RPGCharacter, StatusEffect, ItemDef, Inventory, VisualNovelConfig, VNCommandType, VNCommand, VNChoice, VNScript, VNState, PointAndClickConfig, Hotspot, RoomDef, RoguelikeConfig, TileType, DungeonRoom, DungeonCrawlerConfig, DungeonFloorDef, } from './templates/RPGTemplates';
+export { InventoryManager, InventoryProvider, useInventoryManager, useContainer, useEquipment, } from './inventory/InventorySystem';
+export type { ItemRarity, ItemCategory, EquipmentSlot, StatType, ContainerType, StatModifier, ItemDefinition, ItemInstance, InventorySlot, Container, EquipmentState, CraftingIngredient, CraftingRecipe, LootEntry, LootTable, ShopListing, Shop, InventoryEventType, InventoryEvent, InventoryManagerConfig, InventorySnapshot, } from './inventory/InventorySystem';
 export { DEFAULT_TOP_DOWN_RACING_CONFIG, createRacerState, updateRacer, DEFAULT_SIDE_SCROLLER_RACING_CONFIG, DEFAULT_SOCCER_CONFIG, DEFAULT_BASKETBALL_CONFIG, createSportsState, DEFAULT_GOLF_CONFIG, DEFAULT_BILLIARDS_CONFIG, updateBilliardsBalls, DEFAULT_RHYTHM_CONFIG, createRhythmState, judgeHit, applyHitResult, } from './templates/SportsTemplates';
 export type { TopDownRacingConfig, RacerState, TrackCheckpoint, SideScrollerRacingConfig, SportType, SportsConfig, SportsState, GolfConfig, BilliardsConfig, BilliardsBall, RhythmConfig, NoteType, RhythmNote, RhythmChart, RhythmState, } from './templates/SportsTemplates';
 export { DEFAULT_TOWER_DEFENSE_CONFIG, createTDState, DEFAULT_RTS_CONFIG, createRTSState, DEFAULT_TACTICS_CONFIG, createTurnOrder, nextUnit, DEFAULT_CITY_BUILDER_CONFIG, createCityState, updateCity, DEFAULT_IDLE_CONFIG, createIdleState, getGeneratorCost, getIdleIncome, formatNumber, } from './templates/StrategyTemplates';
@@ -94,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';
@@ -105,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';
@@ -114,14 +116,40 @@ 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';
+export { STANDARD_VERTEX_LAYOUT, INSTANCE_LAYOUT, DEFAULT_PBR, DEFAULT_RENDER_CONFIG, GPUResourceTracker, RenderPipelineManager, WebGPURenderer, PostProcessStack, BLOOM_DEFAULTS, FXAA_DEFAULTS, SSAO_DEFAULTS, DOF_DEFAULTS, COLOR_GRADING_DEFAULTS, QUALITY_PRESET_CONFIGS, applyQualityPreset, } from './rendering/WebGPURenderPipeline';
+export type { GPUTextureFormatType, GPUBlendModeType, ToneMappingMode, MaterialType, RenderPassType, LightCategory, PostEffectType, VertexAttribute, VertexBufferLayout, GPUTextureRef, PBRMaterial, UnlitMaterial, SpriteMaterial, CustomMaterial, RenderMaterial, GPULight, RenderBatch, ClusteredLightConfig, ShadowConfig, PostProcessConfig, PostEffectSettings, WebGPURenderConfig, GPUResourceHandle, GPUStats, RenderPassDescriptor, WebGPURendererState, PostProcessPass, QualityPreset, } from './rendering/WebGPURenderPipeline';
+export { AudioBusMixer, SFXPool, MusicManager, GameAudioBridge, useGameAudio, GameAudioSettings, DEFAULT_SPATIAL, } from './audio/AudioBridge';
+export type { AudioBusType, SpatialModel, AudioPoolStrategy, AudioBusConfig, AudioEffectNode, SpatialAudioConfig, AudioPoolConfig, GameAudioEvent, MusicTrack, MusicCrossfadeConfig, AdaptiveAudioRule, AudioSnapshot, GameAudioSettingsProps, } from './audio/AudioBridge';
+export { DialogueEngine, DialogueTreeBuilder, useTypewriter, DialogueBox, ChoiceList, serializeDialogueTree, deserializeDialogueTree, validateDialogueTree, findUnreachableNodes, extractTranslatableStrings, applyLocalization, DEFAULT_TEXT_SPEED, EMOTION_COLORS, createEmptyDialogueTree, } from './dialogue/DialogueSystem';
+export type { DialogueNodeType, DialogueVarType, ComparisonOp, EmotionType, TextEffectType, DialogueVariable, VariableCondition, DialogueCharacter, DialogueNodeBase, StartNode, TextNode, ChoiceOption, ChoiceNode, BranchNode, SetVariableNode, CheckVariableNode, EventNode, RandomNode, EndNode, DialogueNode, DialogueTree, } from './dialogue/DialogueSystem';
+export { QuestManager, QuestBuilder, QuestList, QuestTracker, createEmptyQuest, DIFFICULTY_COLORS, DIFFICULTY_XP_MULTIPLIERS, } from './quest/QuestSystem';
+export type { QuestType, QuestStatus, QuestDifficulty, QuestPrerequisite, Quest, QuestState as QuestSystemState, QuestJournal as QuestSystemJournal, QuestEventType, QuestEvent, QuestListProps, QuestTrackerProps, RewardType as QuestRewardType, } from './quest/QuestSystem';
+export { compressSaveData, decompressSaveData, crc32, MigrationEngine, SaveSystemV2, DEFAULT_SAVE_CONFIG, } from './engine/SaveSystemV2';
+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/integration/IconSprite.d.ts

@@ -0,0 +1,196 @@
+import type { EntityId, Color } from '../core/types';
+import type { World, AnimatorComponent, SpriteAnimation } from '../ecs/World';
+import type { Renderer2D } from '../rendering/Renderer2D';
+/** Minimal icon component contract (matches @nice2dev/icons-gaming) */
+export interface IconComponent {
+    (props: IconComponentProps): unknown;
+    displayName?: string;
+}
+export interface IconComponentProps {
+    size?: number;
+    animation?: string;
+    color?: string;
+    secondaryColor?: string;
+}
+/** Options for registering an icon as a sprite texture */
+export interface IconSpriteOptions {
+    /** Render size in px (icons will be rasterized at this resolution) */
+    size?: number;
+    /** Primary SVG fill color */
+    color?: string;
+    /** Secondary SVG fill color */
+    secondaryColor?: string;
+    /** Animation state to bake into the texture (default: 'none') */
+    animation?: string;
+}
+/** Configuration for creating an icon-based entity */
+export interface IconEntityOptions extends IconSpriteOptions {
+    /** Entity name override (defaults to icon displayName) */
+    name?: string;
+    /** World position X */
+    x?: number;
+    /** World position Y */
+    y?: number;
+    /** Display width in the game world (default: same as size) */
+    displayWidth?: number;
+    /** Display height in the game world (default: same as size) */
+    displayHeight?: number;
+    /** Sprite layer for depth sorting */
+    layer?: number;
+    /** Tint color multiply */
+    tint?: Color;
+    /** Opacity 0-1 */
+    opacity?: number;
+}
+/** Frame definition for icon animation sheets */
+export interface IconAnimationFrame {
+    animation: string;
+    color?: string;
+    secondaryColor?: string;
+}
+/** Options for creating a multi-frame animation from icon states */
+export interface IconAnimationSheetOptions {
+    /** Icon size per frame */
+    size?: number;
+    /** Base color (can be overridden per frame) */
+    color?: string;
+    /** Frames per second for playback */
+    fps?: number;
+    /** Whether the animation loops */
+    loop?: boolean;
+}
+/**
+ * Render an icon component to an SVG string using React's static markup API.
+ * This function must be called with the result of ReactDOMServer.renderToStaticMarkup().
+ */
+export declare function iconToSvgString(svgMarkup: string, size: number): string;
+/**
+ * Convert an SVG string to a data URL suitable for Image loading.
+ */
+export declare function svgToDataUrl(svgString: string): string;
+/**
+ * Load an SVG data URL into an HTMLImageElement (async).
+ */
+export declare function loadSvgImage(dataUrl: string): Promise<HTMLImageElement>;
+/**
+ * Rasterize an SVG string to an OffscreenCanvas / HTMLCanvasElement.
+ */
+export declare function rasterizeSvg(svgString: string, size: number): Promise<HTMLCanvasElement>;
+/**
+ * Generate a deterministic texture ID for an icon + options combination.
+ */
+export declare function getIconTextureId(displayName: string, options?: IconSpriteOptions): string;
+/**
+ * Register an SVG icon as a texture in the game-engine renderer.
+ *
+ * @param renderer  The Renderer2D instance
+ * @param textureId Unique texture identifier
+ * @param svgMarkup Static SVG markup from ReactDOMServer.renderToStaticMarkup(<Icon ... />)
+ * @param size      Rasterization size in px
+ * @returns         Promise that resolves when the texture is ready
+ *
+ * @example
+ * ```ts
+ * import { renderToStaticMarkup } from 'react-dom/server';
+ * import { GiWarrior } from '@nice2dev/icons-gaming';
+ * import { registerIconTexture, getIconTextureId } from '@nice2dev/game-engine';
+ *
+ * const id = getIconTextureId('GiWarrior', { size: 64 });
+ * const svg = renderToStaticMarkup(<GiWarrior size={64} color="#e74c3c" />);
+ * await registerIconTexture(renderer, id, svg, 64);
+ * ```
+ */
+export declare function registerIconTexture(renderer: Renderer2D, textureId: string, svgMarkup: string, size: number): Promise<void>;
+/**
+ * Register an SVG icon as a rasterized canvas texture (sync-safe after await).
+ * Useful when you need pixel-perfect rendering without scaling artifacts.
+ */
+export declare function registerIconCanvasTexture(renderer: Renderer2D, textureId: string, svgMarkup: string, size: number): Promise<void>;
+/**
+ * Create a game entity with Sprite component sourced from an icon texture.
+ *
+ * The texture must already be registered via `registerIconTexture()`.
+ *
+ * @example
+ * ```ts
+ * const entityId = createIconEntity(world, 'GiWarrior', textureId, {
+ *   x: 200, y: 150, displayWidth: 64, displayHeight: 64, layer: 1,
+ * });
+ * ```
+ */
+export declare function createIconEntity(world: World, name: string, textureId: string, options?: Omit<IconEntityOptions, 'size' | 'color' | 'secondaryColor' | 'animation'>): EntityId;
+/**
+ * Create a SpriteAnimation clip from multiple icon animation frames.
+ *
+ * Each frame is a separate registered texture. The AnimatorComponent
+ * switches `assetId` each frame to show different icon states.
+ *
+ * @param frames  Array of { assetId, duration } for each frame
+ * @param loop    Whether animation loops
+ */
+export declare function createIconAnimationClip(frames: Array<{
+    assetId: string;
+    duration?: number;
+}>, fps?: number, loop?: boolean): SpriteAnimation;
+/**
+ * Predefined character animation state sequences.
+ * Maps game animation concepts to sets of icon animation states
+ * that can be baked into textures.
+ */
+export declare const CHARACTER_ANIMATION_STATES: readonly ["idle", "move", "jump", "attack-melee", "attack-ranged", "attack-magic", "damage", "death"];
+export declare const OBJECT_ANIMATION_STATES: readonly ["idle", "spin", "float", "shake", "glow", "bounce", "flicker"];
+/**
+ * Batch-register all animation states of an icon as separate textures.
+ *
+ * @returns Map of animation state → texture ID
+ *
+ * @example
+ * ```ts
+ * const textures = await registerIconAnimationSet(
+ *   renderer,
+ *   'GiWarrior',
+ *   (anim) => renderToStaticMarkup(<GiWarrior size={64} animation={anim} color="#e74c3c" />),
+ *   CHARACTER_ANIMATION_STATES,
+ *   64,
+ * );
+ * // textures = { idle: 'icon:GiWarrior:s64:aidle', move: 'icon:GiWarrior:s64:amove', ... }
+ * ```
+ */
+export declare function registerIconAnimationSet(renderer: Renderer2D, displayName: string, renderFn: (animation: string) => string, states: readonly string[], size: number): Promise<Record<string, string>>;
+/**
+ * Create an Animator component configuration from a registered animation set.
+ *
+ * @param textureMap Result from `registerIconAnimationSet()`
+ * @param defaultState Initial animation state (default: 'idle')
+ * @param fps Frames per second for each clip
+ */
+export declare function createIconAnimator(textureMap: Record<string, string>, defaultState?: string, fps?: number): Partial<AnimatorComponent>;
+/** Entry in a resolved icon catalog */
+export interface IconCatalogEntry {
+    name: string;
+    textureId: string;
+    category: string;
+}
+/**
+ * Register an entire icon map (e.g. `characterIcons`, `weaponIcons`)
+ * and return a catalog array for the asset manager / picker.
+ *
+ * @param renderer   Renderer2D
+ * @param iconMap    Map of name→icon render functions (SVG markup generators)
+ * @param category   Category label for the asset catalog
+ * @param size       Texture size
+ *
+ * @example
+ * ```ts
+ * const catalog = await registerIconCatalog(
+ *   renderer,
+ *   {
+ *     GiWarrior: () => renderToStaticMarkup(<GiWarrior size={64} color="#e74c3c" />),
+ *     GiMage: () => renderToStaticMarkup(<GiMage size={64} color="#3498db" />),
+ *   },
+ *   'characters',
+ *   64,
+ * );
+ * ```
+ */
+export declare function registerIconCatalog(renderer: Renderer2D, iconMap: Record<string, () => string>, category: string, size: number): Promise<IconCatalogEntry[]>;