@nice2dev/game-engine 0.1.0 → 1.0.3

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

@@ -0,0 +1,34 @@
+/**
+ * @file GodotSceneImporter.ts
+ * @description Import Godot scenes (.tscn) and resources (.tres)
+ * PRO-1.3: Scene Format Interoperability
+ *
+ * Parses Godot 4.x scene format and converts to Nice2Dev entities.
+ * Supports:
+ * - Scene files (.tscn)
+ * - Resource files (.tres)
+ * - Project files (.godot)
+ */
+import { SceneImporter, ImportOptions, ImportResult, ParsedScene, ParsedAsset, ImportError } from './SceneImporter';
+export declare class GodotSceneImporter extends SceneImporter {
+    private extResources;
+    private subResources;
+    private nodes;
+    private connections;
+    private header;
+    constructor();
+    import(options: ImportOptions): Promise<ImportResult>;
+    parseFile(content: string | ArrayBuffer, filePath: string): Promise<ParsedScene | ParsedAsset | null>;
+    validate(sourcePath: string): Promise<ImportError[]>;
+    private parseGodotScene;
+    private saveCurrentItem;
+    private parseInlineParams;
+    private parseGodotValue;
+    private parseGodotArray;
+    private parseGodotDictionary;
+    private convertNodeToEntity;
+    private convertGodotNodeToComponent;
+    private extractVector2;
+    private extractAssets;
+    private readFile;
+}

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

@@ -0,0 +1,177 @@
+/**
+ * @file LDtkImporter.ts
+ * @description Import LDtk (Level Designer Toolkit) files
+ * PRO-1.3: Scene Format Interoperability
+ *
+ * Supports:
+ * - LDtk project files (.ldtk)
+ * - LDtk level files (.ldtkl)
+ *
+ * Features:
+ * - World/Level hierarchy
+ * - IntGrid layers
+ * - Tile layers
+ * - Entity layers
+ * - Auto-layer rules
+ * - Enums
+ * - Level backgrounds
+ */
+import { SceneImporter, ImportOptions, ImportResult, ParsedScene, ParsedAsset, ImportError } from './SceneImporter';
+interface LDtkTileRect {
+    tilesetUid: number;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+interface LDtkIntGridValue {
+    value: number;
+    identifier: string;
+    color: string;
+    tile?: LDtkTileRect;
+    groupUid: number;
+}
+interface LDtkEntityDef {
+    identifier: string;
+    uid: number;
+    tags: string[];
+    exportToToc: boolean;
+    allowOutOfBounds: boolean;
+    doc?: string;
+    width: number;
+    height: number;
+    resizableX: boolean;
+    resizableY: boolean;
+    minWidth?: number;
+    maxWidth?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    keepAspectRatio: boolean;
+    tileOpacity: number;
+    fillOpacity: number;
+    lineOpacity: number;
+    hollow: boolean;
+    color: string;
+    renderMode: 'Rectangle' | 'Ellipse' | 'Tile' | 'Cross';
+    showName: boolean;
+    tilesetId?: number;
+    tileRenderMode: 'Cover' | 'FitInside' | 'Repeat' | 'Stretch' | 'FullSizeCropped' | 'FullSizeUncropped' | 'NineSlice';
+    tileRect?: LDtkTileRect;
+    uiTileRect?: LDtkTileRect;
+    nineSliceBorders: number[];
+    maxCount: number;
+    limitScope: 'PerLayer' | 'PerLevel' | 'PerWorld';
+    limitBehavior: 'MoveLastOne' | 'PreventAdding' | 'DiscardOldOnes';
+    pivotX: number;
+    pivotY: number;
+    fieldDefs: LDtkFieldDef[];
+}
+interface LDtkFieldDef {
+    identifier: string;
+    doc?: string;
+    uid: number;
+    type: string;
+    isArray: boolean;
+    canBeNull: boolean;
+    arrayMinLength?: number;
+    arrayMaxLength?: number;
+    editorDisplayMode: string;
+    editorDisplayScale: number;
+    editorDisplayPos: string;
+    editorLinkStyle: string;
+    editorDisplayColor?: string;
+    editorAlwaysShow: boolean;
+    editorShowInWorld: boolean;
+    editorCutLongValues: boolean;
+    editorTextSuffix?: string;
+    editorTextPrefix?: string;
+    useForSmartColor: boolean;
+    exportToToc: boolean;
+    searchable: boolean;
+    min?: number;
+    max?: number;
+    regex?: string;
+    acceptFileTypes?: string[];
+    defaultOverride?: unknown;
+    textLanguageMode?: string;
+    symmetricalRef: boolean;
+    autoChainRef: boolean;
+    allowOutOfLevelRef: boolean;
+    allowedRefs: string;
+    allowedRefsEntityUid?: number;
+    allowedRefTags: string[];
+    tilesetUid?: number;
+}
+interface LDtkTilesetDef {
+    identifier: string;
+    uid: number;
+    relPath?: string;
+    embedAtlas?: 'LdtkIcons';
+    pxWid: number;
+    pxHei: number;
+    tileGridSize: number;
+    spacing: number;
+    padding: number;
+    tags: string[];
+    tagsSourceEnumUid?: number;
+    enumTags: {
+        enumValueId: string;
+        tileIds: number[];
+    }[];
+    customData: {
+        tileId: number;
+        data: string;
+    }[];
+    savedSelections: {
+        ids: number[];
+        mode: string;
+    }[];
+    cachedPixelData?: Record<string, unknown>;
+}
+interface LDtkEnumDef {
+    identifier: string;
+    uid: number;
+    values: LDtkEnumValue[];
+    iconTilesetUid?: number;
+    externalRelPath?: string;
+    externalFileChecksum?: string;
+    tags: string[];
+}
+interface LDtkEnumValue {
+    id: string;
+    tileRect?: LDtkTileRect;
+    color: number;
+}
+export declare class LDtkImporter extends SceneImporter {
+    private project;
+    private tilesets;
+    private entityDefs;
+    private layerDefs;
+    private enums;
+    constructor();
+    import(options: ImportOptions): Promise<ImportResult>;
+    parseFile(content: string | ArrayBuffer, filePath: string): Promise<ParsedScene | ParsedAsset | null>;
+    validate(sourcePath: string): Promise<ImportError[]>;
+    private indexDefinitions;
+    private getAllLevels;
+    private loadExternalLevels;
+    private convertLevelToScene;
+    private convertLayer;
+    private mapLayerType;
+    private convertTile;
+    private gridTilesToArray;
+    private convertEntity;
+    private convertFieldToComponent;
+    private convertFieldInstances;
+    private extractAssets;
+    private readFile;
+    /** Get IntGrid value definition by value */
+    getIntGridValue(layerUid: number, value: number): LDtkIntGridValue | undefined;
+    /** Get enum definition and values */
+    getEnum(identifier: string): LDtkEnumDef | undefined;
+    /** Get entity definition */
+    getEntityDef(uid: number): LDtkEntityDef | undefined;
+    /** Get tileset definition */
+    getTileset(uid: number): LDtkTilesetDef | undefined;
+}
+export {};

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

@@ -0,0 +1,237 @@
+/**
+ * @file Live2DImporter.ts
+ * @description Live2D Cubism Model Importer
+ * PRO-1.3: Scene Format Interoperability
+ *
+ * Live2D is a technology for animating 2D characters.
+ * Supports Cubism 3.0+ model format.
+ *
+ * File Types:
+ * - *.model3.json - Model settings
+ * - *.moc3 - Model data (binary)
+ * - *.physics3.json - Physics settings
+ * - *.pose3.json - Pose settings
+ * - *.exp3.json - Expression settings
+ * - *.motion3.json - Motion data
+ * - *.cdi3.json - Display info
+ */
+import { SceneImporter, ImportOptions, ImportResult, ParsedScene, ImportError } from './SceneImporter';
+/** Live2D Model Settings (model3.json) */
+export interface L2DModelSettings {
+    Version: number;
+    FileReferences: L2DFileReferences;
+    Groups?: L2DGroup[];
+    HitAreas?: L2DHitArea[];
+}
+export interface L2DFileReferences {
+    Moc: string;
+    Textures: string[];
+    Physics?: string;
+    Pose?: string;
+    DisplayInfo?: string;
+    Expressions?: L2DExpressionRef[];
+    Motions?: Record<string, L2DMotionRef[]>;
+    UserData?: string;
+}
+export interface L2DExpressionRef {
+    Name: string;
+    File: string;
+}
+export interface L2DMotionRef {
+    File: string;
+    FadeInTime?: number;
+    FadeOutTime?: number;
+    Sound?: string;
+    MotionSync?: string;
+}
+export interface L2DGroup {
+    Target: 'Parameter' | 'Part';
+    Name: string;
+    Ids: string[];
+}
+export interface L2DHitArea {
+    Id: string;
+    Name: string;
+}
+/** Live2D Physics Settings (physics3.json) */
+export interface L2DPhysics {
+    Version: number;
+    Meta: L2DPhysicsMeta;
+    PhysicsSettings: L2DPhysicsSetting[];
+}
+export interface L2DPhysicsMeta {
+    PhysicsSettingCount: number;
+    TotalInputCount: number;
+    TotalOutputCount: number;
+    VertexCount: number;
+    EffectiveForces?: {
+        Gravity: {
+            X: number;
+            Y: number;
+        };
+        Wind: {
+            X: number;
+            Y: number;
+        };
+    };
+    PhysicsDictionary?: L2DPhysicsDictEntry[];
+}
+export interface L2DPhysicsDictEntry {
+    Id: string;
+    Name: string;
+}
+export interface L2DPhysicsSetting {
+    Id: string;
+    Input: L2DPhysicsInput[];
+    Output: L2DPhysicsOutput[];
+    Vertices: L2DPhysicsVertex[];
+    Normalization: L2DPhysicsNormalization;
+}
+export interface L2DPhysicsInput {
+    Source: L2DPhysicsParameter;
+    Weight: number;
+    Type: 'X' | 'Y' | 'Angle';
+    Reflect: boolean;
+}
+export interface L2DPhysicsOutput {
+    Destination: L2DPhysicsParameter;
+    VertexIndex: number;
+    Scale: number;
+    Weight: number;
+    Type: 'X' | 'Y' | 'Angle';
+    Reflect: boolean;
+}
+export interface L2DPhysicsParameter {
+    Target: 'Parameter' | 'Part';
+    Id: string;
+}
+export interface L2DPhysicsVertex {
+    Position: {
+        X: number;
+        Y: number;
+    };
+    Mobility: number;
+    Delay: number;
+    Acceleration: number;
+    Radius: number;
+}
+export interface L2DPhysicsNormalization {
+    Position: L2DPhysicsNormValue;
+    Angle: L2DPhysicsNormValue;
+}
+export interface L2DPhysicsNormValue {
+    Minimum: number;
+    Default: number;
+    Maximum: number;
+}
+/** Live2D Pose Settings (pose3.json) */
+export interface L2DPose {
+    Version: number;
+    Type: 'Live2D Pose';
+    FadeInTime?: number;
+    Groups: L2DPoseGroup[][];
+}
+export interface L2DPoseGroup {
+    Id: string;
+    Link?: string[];
+}
+/** Live2D Expression (exp3.json) */
+export interface L2DExpression {
+    Version: number;
+    Type: 'Live2D Expression';
+    FadeInTime?: number;
+    FadeOutTime?: number;
+    Parameters?: L2DExpressionParameter[];
+}
+export interface L2DExpressionParameter {
+    Id: string;
+    Value: number;
+    Blend?: 'Add' | 'Multiply' | 'Overwrite';
+}
+/** Live2D Motion (motion3.json) */
+export interface L2DMotion {
+    Version: number;
+    Meta: L2DMotionMeta;
+    Curves: L2DMotionCurve[];
+    UserData?: L2DUserDataEvent[];
+}
+export interface L2DMotionMeta {
+    Duration: number;
+    Fps: number;
+    Loop?: boolean;
+    AreBeziersRestricted?: boolean;
+    CurveCount: number;
+    TotalSegmentCount: number;
+    TotalPointCount: number;
+    UserDataCount?: number;
+    TotalUserDataSize?: number;
+}
+export interface L2DMotionCurve {
+    Target: 'Model' | 'Parameter' | 'PartOpacity';
+    Id: string;
+    FadeInTime?: number;
+    FadeOutTime?: number;
+    Segments: number[];
+}
+export interface L2DUserDataEvent {
+    Time: number;
+    Value: string;
+}
+/** Live2D Display Info (cdi3.json) */
+export interface L2DDisplayInfo {
+    Version: number;
+    Parameters?: L2DParameterInfo[];
+    ParameterGroups?: L2DParameterGroupInfo[];
+    Parts?: L2DPartInfo[];
+}
+export interface L2DParameterInfo {
+    Id: string;
+    GroupId?: string;
+    Name?: string;
+}
+export interface L2DParameterGroupInfo {
+    Id: string;
+    GroupId?: string;
+    Name?: string;
+}
+export interface L2DPartInfo {
+    Id: string;
+    Name?: string;
+}
+/** Live2D User Data */
+export interface L2DUserData {
+    Version: number;
+    Meta: {
+        UserDataCount: number;
+        TotalUserDataSize: number;
+    };
+    UserData: L2DUserDataEntry[];
+}
+export interface L2DUserDataEntry {
+    Target: 'ArtMesh' | 'DrawOrder';
+    Id: string;
+    Value: string;
+}
+export declare class Live2DImporter extends SceneImporter {
+    private model;
+    private physics;
+    private pose;
+    private displayInfo;
+    private expressions;
+    private motions;
+    constructor();
+    canHandle(filePath: string): boolean;
+    import(options: ImportOptions): Promise<ImportResult>;
+    parseFile(content: string | ArrayBuffer, filePath: string): Promise<ParsedScene | null>;
+    validate(sourcePath: string): Promise<ImportError[]>;
+    private loadDependencies;
+    private convertModelToScene;
+    private convertModelToParsed;
+    private convertMotionCurves;
+    private getSegmentTypes;
+    private countKeyframes;
+    private readFile;
+    private getBaseDirectory;
+    private extractFileName;
+}
+export declare function createLive2DImporter(): Live2DImporter;