@nice2dev/game-engine 1.1.5 → 1.1.6

package/dist/types/unity-integration/UnityImport.d.ts

@@ -0,0 +1,407 @@
+/**
+ * @file UnityImport.ts
+ * @description Unity Project Import system for Nice2Dev Game Engine
+ * PRO-1.8.1: Unity Project Import
+ *
+ * Features:
+ * - Unity Project Importer (scene, prefab, hierarchy, components)
+ * - Unity Asset Database Integration (meta files, GUIDs, dependencies)
+ * - Unity Animation Import (clips, controllers, masks, events)
+ * - Unity Script Import (MonoBehaviour parsing, SerializeField extraction)
+ */
+export type UnityComponentType = 'Transform' | 'RectTransform' | 'MeshRenderer' | 'SkinnedMeshRenderer' | 'MeshFilter' | 'Camera' | 'Light' | 'AudioSource' | 'AudioListener' | 'Rigidbody' | 'Rigidbody2D' | 'Collider' | 'BoxCollider' | 'SphereCollider' | 'CapsuleCollider' | 'MeshCollider' | 'BoxCollider2D' | 'CircleCollider2D' | 'PolygonCollider2D' | 'Animator' | 'Animation' | 'SpriteRenderer' | 'ParticleSystem' | 'Canvas' | 'CanvasRenderer' | 'Image' | 'Text' | 'TextMeshPro' | 'Button' | 'MonoBehaviour' | 'NavMeshAgent' | 'Terrain' | 'LODGroup' | 'ReflectionProbe' | 'LightProbeGroup' | 'Joint' | 'CharacterController' | 'Unknown';
+export type UnityRenderPipeline = 'builtin' | 'urp' | 'hdrp';
+export type UnityAssetType = 'scene' | 'prefab' | 'material' | 'texture' | 'mesh' | 'animation' | 'animator' | 'audio' | 'script' | 'shader' | 'scriptableobject' | 'unknown';
+export type UnitySerializedFieldType = 'int' | 'float' | 'bool' | 'string' | 'Vector2' | 'Vector3' | 'Vector4' | 'Quaternion' | 'Color' | 'LayerMask' | 'AnimationCurve' | 'Gradient' | 'Object' | 'Array' | 'Enum' | 'Custom';
+export interface UnityYAMLDocument {
+    /** File ID (local ID in scene/prefab) */
+    fileID: number;
+    /** Class ID (Unity internal type) */
+    classID: number;
+    /** Stripped flag */
+    stripped?: boolean;
+    /** Raw data */
+    data: Record<string, unknown>;
+}
+export interface UnityGUID {
+    /** GUID string (32 hex chars) */
+    guid: string;
+    /** File ID within asset */
+    fileID?: number;
+    /** Type (usually 2 for assets, 3 for built-in) */
+    type?: number;
+}
+export interface UnityMetaFile {
+    /** GUID of the asset */
+    guid: string;
+    /** Importer type */
+    importerType: string;
+    /** Import settings */
+    importSettings: Record<string, unknown>;
+    /** Timestamp */
+    timestamp?: number;
+    /** User data */
+    userData?: string;
+}
+export declare function parseUnityYAML(content: string): UnityYAMLDocument[];
+export declare function parseUnityMeta(content: string): UnityMetaFile;
+export declare function getUnityClassName(classID: number): string;
+export interface UnityTransformData {
+    localPosition: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    localRotation: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    localScale: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    children?: UnityGUID[];
+    parent?: UnityGUID;
+}
+export interface UnityGameObjectData {
+    name: string;
+    tag: string;
+    layer: number;
+    isActive: boolean;
+    isStatic: boolean;
+    components: UnityGUID[];
+}
+export interface UnitySceneObject {
+    /** File ID */
+    fileID: number;
+    /** Object type */
+    type: string;
+    /** Class ID */
+    classID: number;
+    /** Parsed data */
+    data: Record<string, unknown>;
+}
+export interface UnityScene {
+    /** Scene name */
+    name: string;
+    /** Scene path */
+    path: string;
+    /** All objects in scene */
+    objects: Map<number, UnitySceneObject>;
+    /** Root game objects */
+    roots: number[];
+    /** Render settings */
+    renderSettings?: Record<string, unknown>;
+    /** Light map settings */
+    lightmapSettings?: Record<string, unknown>;
+    /** Nav mesh settings */
+    navMeshSettings?: Record<string, unknown>;
+    /** Occlusion culling settings */
+    occlusionSettings?: Record<string, unknown>;
+}
+export interface UnityPrefab {
+    /** Prefab name */
+    name: string;
+    /** Prefab GUID */
+    guid: string;
+    /** Prefab path */
+    path: string;
+    /** Root game object file ID */
+    rootFileID: number;
+    /** All objects */
+    objects: Map<number, UnitySceneObject>;
+    /** Is prefab variant */
+    isVariant: boolean;
+    /** Base prefab GUID (if variant) */
+    basePrefabGUID?: string;
+}
+export interface UnityProjectInfo {
+    /** Project name */
+    name: string;
+    /** Project path */
+    path: string;
+    /** Unity version */
+    unityVersion: string;
+    /** Render pipeline */
+    renderPipeline: UnityRenderPipeline;
+    /** All assets by GUID */
+    assets: Map<string, UnityAssetInfo>;
+    /** Scenes */
+    scenes: UnitySceneInfo[];
+    /** Prefabs */
+    prefabs: UnityPrefabInfo[];
+    /** Scripts */
+    scripts: UnityScriptInfo[];
+    /** Materials */
+    materials: UnityMaterialInfo[];
+    /** Missing references */
+    missingRefs: UnityMissingRef[];
+}
+export interface UnityAssetInfo {
+    /** Asset GUID */
+    guid: string;
+    /** Asset path (relative to Assets/) */
+    path: string;
+    /** Asset type */
+    type: UnityAssetType;
+    /** Import settings */
+    importSettings?: Record<string, unknown>;
+    /** Dependencies (GUIDs) */
+    dependencies: string[];
+    /** Dependents (GUIDs that reference this) */
+    dependents: string[];
+}
+export interface UnitySceneInfo extends UnityAssetInfo {
+    type: 'scene';
+    /** Scene index in build settings (-1 if not in build) */
+    buildIndex: number;
+    /** Root object count */
+    rootCount: number;
+    /** Total object count */
+    objectCount: number;
+}
+export interface UnityPrefabInfo extends UnityAssetInfo {
+    type: 'prefab';
+    /** Is prefab variant */
+    isVariant: boolean;
+    /** Base prefab GUID */
+    basePrefab?: string;
+    /** Nested prefabs */
+    nestedPrefabs: string[];
+}
+export interface UnityScriptInfo extends UnityAssetInfo {
+    type: 'script';
+    /** C# class name */
+    className: string;
+    /** Namespace */
+    namespace?: string;
+    /** Is MonoBehaviour */
+    isMonoBehaviour: boolean;
+    /** Is ScriptableObject */
+    isScriptableObject: boolean;
+    /** Serialized fields */
+    serializedFields: UnitySerializedField[];
+    /** Public methods */
+    publicMethods: string[];
+    /** Unity messages (Start, Update, etc.) */
+    unityMessages: string[];
+}
+export interface UnitySerializedField {
+    /** Field name */
+    name: string;
+    /** Field type */
+    type: UnitySerializedFieldType;
+    /** Custom type name (if Custom) */
+    customType?: string;
+    /** Is array */
+    isArray: boolean;
+    /** Is public */
+    isPublic: boolean;
+    /** Has SerializeField attribute */
+    hasSerializeField: boolean;
+    /** Has Header attribute */
+    header?: string;
+    /** Has Tooltip attribute */
+    tooltip?: string;
+    /** Has Range attribute */
+    range?: {
+        min: number;
+        max: number;
+    };
+    /** Default value */
+    defaultValue?: unknown;
+}
+export interface UnityMaterialInfo extends UnityAssetInfo {
+    type: 'material';
+    /** Shader name */
+    shaderName: string;
+    /** Shader GUID */
+    shaderGUID?: string;
+    /** Texture properties */
+    textures: Record<string, string | null>;
+    /** Float properties */
+    floats: Record<string, number>;
+    /** Color properties */
+    colors: Record<string, {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }>;
+    /** Vector properties */
+    vectors: Record<string, {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    }>;
+    /** Render queue */
+    renderQueue: number;
+    /** Keywords */
+    keywords: string[];
+}
+export interface UnityMissingRef {
+    /** Asset with missing reference */
+    assetGUID: string;
+    /** Asset path */
+    assetPath: string;
+    /** Missing reference GUID */
+    missingGUID: string;
+    /** Property path where reference is missing */
+    propertyPath: string;
+}
+export declare class UnityProjectImporter {
+    private project;
+    private callbacks;
+    constructor();
+    scanProject(projectPath: string): Promise<UnityProjectInfo>;
+    private extractProjectName;
+    private detectUnityVersion;
+    private detectRenderPipeline;
+    private scanAssetsFolder;
+    importScene(scenePath: string, sceneContent: string): Promise<UnityScene>;
+    private extractFileName;
+    importPrefab(prefabPath: string, prefabContent: string, guid: string): Promise<UnityPrefab>;
+    parseScript(scriptPath: string, scriptContent: string, guid: string): UnityScriptInfo;
+    private parseFieldDeclaration;
+    private mapCSharpType;
+    private isCustomType;
+    private parseFieldAttributes;
+    parseMaterial(matPath: string, matContent: string, guid: string): UnityMaterialInfo;
+    parseAnimationClip(clipPath: string, clipContent: string, guid: string): UnityAnimationClipInfo;
+    private parseCurve;
+    private parseAnimationEvent;
+    parseAnimatorController(controllerPath: string, controllerContent: string, guid: string): UnityAnimatorControllerInfo;
+    private mapAnimatorParameterType;
+    private mapConditionMode;
+    private buildDependencyGraph;
+    private detectMissingReferences;
+    convertSceneToNice2Dev(scene: UnityScene): Nice2DevSceneData;
+    private convertGameObject;
+    private convertComponent;
+    private mapLightType;
+    private mapRigidBodyType;
+    private extractMonoBehaviourData;
+    setCallbacks(callbacks: UnityImportCallbacks): void;
+}
+export interface UnityAnimationClipInfo {
+    guid: string;
+    path: string;
+    name: string;
+    length: number;
+    frameRate: number;
+    wrapMode: 'Default' | 'Once' | 'Loop' | 'PingPong' | 'ClampForever';
+    isLooping: boolean;
+    curves: UnityAnimationCurve[];
+    events: UnityAnimationEvent[];
+}
+export interface UnityAnimationCurve {
+    path: string;
+    propertyName: string;
+    type: string;
+    keyframes: Array<{
+        time: number;
+        value: number;
+        inTangent: number;
+        outTangent: number;
+    }>;
+}
+export interface UnityAnimationEvent {
+    time: number;
+    functionName: string;
+    stringParameter?: string;
+    floatParameter?: number;
+    intParameter?: number;
+    objectReferenceParameter?: string;
+}
+export interface UnityAnimatorControllerInfo {
+    guid: string;
+    path: string;
+    name: string;
+    parameters: UnityAnimatorParameter[];
+    layers: UnityAnimatorLayer[];
+}
+export interface UnityAnimatorParameter {
+    name: string;
+    type: 'Float' | 'Int' | 'Bool' | 'Trigger';
+    defaultValue: number | boolean;
+}
+export interface UnityAnimatorLayer {
+    name: string;
+    stateMachine: {
+        fileID: number;
+        states: UnityAnimatorState[];
+        transitions: UnityAnimatorTransition[];
+        defaultStateIndex: number;
+    };
+    weight: number;
+    blendingMode: 'Override' | 'Additive';
+}
+export interface UnityAnimatorState {
+    fileID: number;
+    name: string;
+    speed: number;
+    motionGUID?: string;
+    transitions: number[];
+}
+export interface UnityAnimatorTransition {
+    fileID: number;
+    destinationStateID: number;
+    hasExitTime: boolean;
+    exitTime: number;
+    duration: number;
+    conditions: UnityAnimatorCondition[];
+}
+export interface UnityAnimatorCondition {
+    parameter: string;
+    mode: 'If' | 'IfNot' | 'Greater' | 'Less' | 'Equals' | 'NotEquals';
+    threshold: number;
+}
+export interface Nice2DevSceneData {
+    name: string;
+    entities: Nice2DevEntityData[];
+    cameras: Nice2DevEntityData[];
+    lights: Nice2DevEntityData[];
+}
+export interface Nice2DevEntityData {
+    name: string;
+    active: boolean;
+    tag: string;
+    layer: number;
+    transform: {
+        position: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        rotation: {
+            x: number;
+            y: number;
+            z: number;
+            w: number;
+        };
+        scale: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    };
+    components: Nice2DevComponentData[];
+    children: Nice2DevEntityData[];
+}
+export interface Nice2DevComponentData {
+    type: string;
+    data: Record<string, unknown>;
+}
+export interface UnityImportCallbacks {
+    onProjectScanned?: (project: UnityProjectInfo) => void;
+    onSceneImported?: (scene: UnityScene) => void;
+    onPrefabImported?: (prefab: UnityPrefab) => void;
+    onScriptParsed?: (script: UnityScriptInfo) => void;
+    onMaterialParsed?: (material: UnityMaterialInfo) => void;
+    onScanProgress?: (message: string, progress: number) => void;
+}
+export declare function createUnityProjectImporter(): UnityProjectImporter;