@nice2dev/game-engine 1.1.5 → 1.1.7

package/dist/types/editor/NiceLevelEditor.d.ts

@@ -0,0 +1,232 @@
+import { type NiceComponentTutorial } from '@nice2dev/ui';
+import React from 'react';
+export interface LevelLayer {
+    id: string;
+    name: string;
+    type: 'default' | 'terrain' | 'foliage' | 'props' | 'lighting' | 'navmesh' | 'streaming';
+    visible: boolean;
+    locked: boolean;
+    color: string;
+    objectIds: string[];
+}
+export interface LevelObject {
+    id: string;
+    name: string;
+    type: 'mesh' | 'light' | 'camera' | 'trigger' | 'spline' | 'volume' | 'probe' | 'spawner' | 'waypoint';
+    layerId: string;
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    rotation: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    scale: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    properties: Record<string, unknown>;
+    prefabId?: string;
+    visible: boolean;
+    selected: boolean;
+}
+export interface TerrainData {
+    id: string;
+    size: {
+        x: number;
+        y: number;
+    };
+    resolution: number;
+    heightmap: Float32Array | null;
+    layers: TerrainLayer[];
+    trees: TreeInstance[];
+    details: DetailInstance[];
+}
+export interface TerrainLayer {
+    id: string;
+    name: string;
+    diffuseTexture?: string;
+    normalTexture?: string;
+    tileSize: {
+        x: number;
+        y: number;
+    };
+    tileOffset: {
+        x: number;
+        y: number;
+    };
+    metallic: number;
+    smoothness: number;
+}
+export interface TreeInstance {
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    prototypeIndex: number;
+    scale: number;
+    rotation: number;
+    color: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    lightmapColor: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+}
+export interface DetailInstance {
+    position: {
+        x: number;
+        y: number;
+    };
+    prototypeIndex: number;
+    density: number;
+}
+export interface SplineData {
+    id: string;
+    name: string;
+    type: 'bezier' | 'catmull-rom' | 'linear';
+    closed: boolean;
+    points: SplinePoint[];
+    meshMode: 'none' | 'extrude' | 'tube' | 'scatter';
+    meshSettings: Record<string, unknown>;
+}
+export interface SplinePoint {
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    tangentIn?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    tangentOut?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    roll: number;
+    scale: {
+        x: number;
+        y: number;
+    };
+}
+export interface StreamingZone {
+    id: string;
+    name: string;
+    bounds: {
+        min: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        max: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    };
+    levelName: string;
+    priority: number;
+    behavior: 'distance' | 'trigger' | 'always';
+}
+export interface LevelData {
+    id: string;
+    name: string;
+    layers: LevelLayer[];
+    objects: LevelObject[];
+    terrain?: TerrainData;
+    splines: SplineData[];
+    streamingZones: StreamingZone[];
+    lightmapSettings: LightmapSettings;
+    navmeshSettings: NavmeshSettings;
+    environmentSettings: EnvironmentSettings;
+}
+export interface LightmapSettings {
+    resolution: number;
+    padding: number;
+    directSamples: number;
+    indirectSamples: number;
+    bounces: number;
+    compression: 'none' | 'low' | 'normal' | 'high';
+    directionalMode: 'directional' | 'non-directional';
+}
+export interface NavmeshSettings {
+    agentRadius: number;
+    agentHeight: number;
+    maxSlope: number;
+    stepHeight: number;
+    cellSize: number;
+    cellHeight: number;
+}
+export interface EnvironmentSettings {
+    skybox?: string;
+    ambientMode: 'color' | 'gradient' | 'skybox';
+    ambientColor: {
+        r: number;
+        g: number;
+        b: number;
+    };
+    ambientIntensity: number;
+    fogEnabled: boolean;
+    fogColor: {
+        r: number;
+        g: number;
+        b: number;
+    };
+    fogDensity: number;
+    fogStart: number;
+    fogEnd: number;
+}
+export type LevelTool = 'select' | 'move' | 'rotate' | 'scale' | 'terrain-raise' | 'terrain-lower' | 'terrain-smooth' | 'terrain-flatten' | 'terrain-paint' | 'foliage-paint' | 'foliage-erase' | 'spline-create' | 'spline-edit' | 'measure' | 'probe-place';
+export interface LevelEditorTheme {
+    background: string;
+    panelBackground: string;
+    headerBackground: string;
+    toolbarBackground: string;
+    viewportBackground: string;
+    gridColor: string;
+    selectionColor: string;
+    activeToolColor: string;
+    layerVisible: string;
+    layerHidden: string;
+    textPrimary: string;
+    textSecondary: string;
+    accent: string;
+    danger: string;
+}
+export interface NiceLevelEditorProps {
+    level?: LevelData;
+    theme?: Partial<LevelEditorTheme>;
+    readOnly?: boolean;
+    onLevelChange?: (level: LevelData) => void;
+    className?: string;
+    style?: React.CSSProperties;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+export interface NiceLevelEditorRef {
+    getLevel: () => LevelData;
+    addObject: (type: LevelObject['type'], position?: {
+        x: number;
+        y: number;
+        z: number;
+    }) => void;
+    removeObjects: (ids: string[]) => void;
+    bakeLightmaps: () => Promise<void>;
+    generateNavmesh: () => Promise<void>;
+}
+export declare const NiceLevelEditor: React.ForwardRefExoticComponent<NiceLevelEditorProps & React.RefAttributes<NiceLevelEditorRef>>;
+export default NiceLevelEditor;

package/dist/types/editor/NiceMaterialEditor.d.ts

@@ -0,0 +1,105 @@
+import { type NiceComponentTutorial } from '@nice2dev/ui';
+import React from 'react';
+export type ShaderNodeType = 'texture2d' | 'textureCube' | 'constant' | 'parameter' | 'time' | 'position' | 'normal' | 'uv' | 'vertexColor' | 'add' | 'subtract' | 'multiply' | 'divide' | 'power' | 'sqrt' | 'abs' | 'lerp' | 'clamp' | 'saturate' | 'step' | 'smoothstep' | 'min' | 'max' | 'floor' | 'ceil' | 'frac' | 'sin' | 'cos' | 'normalize' | 'dot' | 'cross' | 'reflect' | 'refract' | 'length' | 'distance' | 'split' | 'combine' | 'swizzle' | 'rgbToHsv' | 'hsvToRgb' | 'contrast' | 'saturation' | 'blend' | 'fresnel' | 'panner' | 'rotator' | 'noise' | 'voronoi' | 'gradient' | 'pbr_output' | 'unlit_output' | 'custom_output';
+export interface ShaderPin {
+    id: string;
+    name: string;
+    type: 'float' | 'vec2' | 'vec3' | 'vec4' | 'sampler2D' | 'samplerCube' | 'mat3' | 'mat4';
+    direction: 'input' | 'output';
+    defaultValue?: number[];
+    connected?: boolean;
+}
+export interface ShaderNode {
+    id: string;
+    type: ShaderNodeType;
+    name: string;
+    x: number;
+    y: number;
+    pins: ShaderPin[];
+    properties: Record<string, unknown>;
+    preview?: boolean;
+    collapsed?: boolean;
+}
+export interface ShaderConnection {
+    id: string;
+    sourceNodeId: string;
+    sourcePinId: string;
+    targetNodeId: string;
+    targetPinId: string;
+}
+export interface MaterialData {
+    id: string;
+    name: string;
+    shaderType: 'pbr' | 'unlit' | 'custom';
+    nodes: ShaderNode[];
+    connections: ShaderConnection[];
+    parameters: MaterialParameter[];
+    textures: MaterialTexture[];
+    renderState: RenderState;
+    compiledShader?: string;
+}
+export interface MaterialParameter {
+    id: string;
+    name: string;
+    type: 'float' | 'vec2' | 'vec3' | 'vec4' | 'color';
+    value: number[];
+    min?: number;
+    max?: number;
+    exposed: boolean;
+}
+export interface MaterialTexture {
+    id: string;
+    name: string;
+    slot: string;
+    url?: string;
+    tiling: {
+        x: number;
+        y: number;
+    };
+    offset: {
+        x: number;
+        y: number;
+    };
+}
+export interface RenderState {
+    cullMode: 'none' | 'front' | 'back';
+    blendMode: 'opaque' | 'transparent' | 'additive' | 'multiply';
+    depthWrite: boolean;
+    depthTest: boolean;
+    doubleSided: boolean;
+}
+export interface MaterialEditorTheme {
+    background: string;
+    nodeBackground: string;
+    nodeHeader: string;
+    nodeHeaderText: string;
+    nodeBorder: string;
+    nodeSelected: string;
+    connectionLine: string;
+    gridColor: string;
+    textPrimary: string;
+    textSecondary: string;
+    pinFloat: string;
+    pinVec2: string;
+    pinVec3: string;
+    pinVec4: string;
+    pinSampler: string;
+}
+export interface NiceMaterialEditorProps {
+    material?: MaterialData;
+    theme?: Partial<MaterialEditorTheme>;
+    readOnly?: boolean;
+    onMaterialChange?: (material: MaterialData) => void;
+    onCompile?: (shader: string) => void;
+    className?: string;
+    style?: React.CSSProperties;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+export interface NiceMaterialEditorRef {
+    getMaterial: () => MaterialData;
+    compile: () => void;
+    addNode: (type: ShaderNodeType, x: number, y: number) => void;
+}
+export declare const NiceMaterialEditor: React.ForwardRefExoticComponent<NiceMaterialEditorProps & React.RefAttributes<NiceMaterialEditorRef>>;
+export default NiceMaterialEditor;

package/dist/types/editor/NiceNodeGraph.d.ts

@@ -0,0 +1,87 @@
+import React from 'react';
+import { VisualScriptGraph } from '../visual-scripting/VisualScriptGraph';
+export interface NodePosition {
+    x: number;
+    y: number;
+}
+export interface NodeGraphTheme {
+    background: string;
+    gridColor: string;
+    gridMajorColor: string;
+    nodeBackground: string;
+    nodeBorder: string;
+    nodeSelectedBorder: string;
+    nodeHeaderBackground: string;
+    pinExecution: string;
+    pinBoolean: string;
+    pinNumber: string;
+    pinString: string;
+    pinVector: string;
+    pinObject: string;
+    pinArray: string;
+    pinAny: string;
+    connectionLine: string;
+    connectionLineExecution: string;
+    textPrimary: string;
+    textSecondary: string;
+    groupBackground: string;
+    groupBorder: string;
+    breakpointColor: string;
+    executionHighlight: string;
+}
+export interface NodeCategory {
+    id: string;
+    name: string;
+    icon: string;
+    color: string;
+}
+export interface NodeGraphState {
+    zoom: number;
+    panOffset: NodePosition;
+    selectedNodes: string[];
+    hoveredNode: string | null;
+    hoveredPin: {
+        nodeId: string;
+        pinId: string;
+        isOutput: boolean;
+    } | null;
+    draggingNode: string | null;
+    connecting: {
+        sourceNodeId: string;
+        sourcePinId: string;
+        isOutput: boolean;
+        mousePos: NodePosition;
+    } | null;
+    selectionBox: {
+        start: NodePosition;
+        end: NodePosition;
+    } | null;
+    contextMenu: {
+        x: number;
+        y: number;
+        type: 'canvas' | 'node' | 'connection';
+        targetId?: string;
+    } | null;
+    searchQuery: string;
+    showLibrary: boolean;
+    showVariables: boolean;
+    showCodePreview: boolean;
+    activeBreakpoints: Set<string>;
+    executingNode: string | null;
+}
+export interface NiceNodeGraphProps {
+    graph?: VisualScriptGraph;
+    theme?: Partial<NodeGraphTheme>;
+    readOnly?: boolean;
+    onGraphChange?: (graph: VisualScriptGraph) => void;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export interface NiceNodeGraphRef {
+    getGraph: () => VisualScriptGraph;
+    addNode: (typeId: string, position: NodePosition) => void;
+    zoomToFit: () => void;
+    clearSelection: () => void;
+}
+export declare const NiceNodeGraph: React.ForwardRefExoticComponent<NiceNodeGraphProps & React.RefAttributes<NiceNodeGraphRef>>;
+export default NiceNodeGraph;

package/dist/types/editor/NiceParticleEditor.d.ts

@@ -0,0 +1,127 @@
+import { type NiceComponentTutorial } from '@nice2dev/ui';
+import React from 'react';
+export interface ParticleCurve {
+    type: 'constant' | 'linear' | 'curve' | 'randomBetweenCurves';
+    value?: number;
+    min?: number;
+    max?: number;
+    keys?: Array<{
+        time: number;
+        value: number;
+        inTangent?: number;
+        outTangent?: number;
+    }>;
+    keys2?: Array<{
+        time: number;
+        value: number;
+        inTangent?: number;
+        outTangent?: number;
+    }>;
+}
+export interface ParticleGradient {
+    type: 'constant' | 'gradient' | 'randomBetweenGradients';
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    keys?: Array<{
+        time: number;
+        color: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+    }>;
+    keys2?: Array<{
+        time: number;
+        color: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+    }>;
+}
+export interface EmitterShape {
+    type: 'sphere' | 'hemisphere' | 'cone' | 'box' | 'circle' | 'edge' | 'mesh';
+    radius?: number;
+    angle?: number;
+    arc?: number;
+    length?: number;
+    boxSize?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    emitFromShell?: boolean;
+    randomDirection?: boolean;
+}
+export interface ParticleModule {
+    id: string;
+    type: ParticleModuleType;
+    enabled: boolean;
+    properties: Record<string, unknown>;
+}
+export type ParticleModuleType = 'emission' | 'shape' | 'velocity' | 'lifetime' | 'speed' | 'size' | 'rotation' | 'color' | 'gravity' | 'noise' | 'collision' | 'subEmitters' | 'textureSheet' | 'trails' | 'lights' | 'customData';
+export interface ParticleSystemData {
+    id: string;
+    name: string;
+    duration: number;
+    looping: boolean;
+    prewarm: boolean;
+    startDelay: ParticleCurve;
+    startLifetime: ParticleCurve;
+    startSpeed: ParticleCurve;
+    startSize: ParticleCurve;
+    startRotation: ParticleCurve;
+    startColor: ParticleGradient;
+    gravityModifier: ParticleCurve;
+    simulationSpace: 'local' | 'world';
+    simulationSpeed: number;
+    maxParticles: number;
+    playOnAwake: boolean;
+    modules: ParticleModule[];
+    renderMode: 'billboard' | 'stretchedBillboard' | 'horizontalBillboard' | 'verticalBillboard' | 'mesh';
+    material?: string;
+    mesh?: string;
+    sortMode: 'none' | 'distance' | 'oldestFirst' | 'youngestFirst';
+    blendMode: 'additive' | 'alpha' | 'multiply' | 'premultiply';
+}
+export interface ParticleEditorTheme {
+    background: string;
+    panelBackground: string;
+    headerBackground: string;
+    moduleBackground: string;
+    moduleBackgroundAlt: string;
+    moduleHeader: string;
+    previewBackground: string;
+    gridColor: string;
+    curveColor: string;
+    curveHandle: string;
+    gradientTrack: string;
+    textPrimary: string;
+    textSecondary: string;
+    accent: string;
+    danger: string;
+}
+export interface NiceParticleEditorProps {
+    system?: ParticleSystemData;
+    theme?: Partial<ParticleEditorTheme>;
+    readOnly?: boolean;
+    onSystemChange?: (system: ParticleSystemData) => void;
+    className?: string;
+    style?: React.CSSProperties;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+export interface NiceParticleEditorRef {
+    getSystem: () => ParticleSystemData;
+    play: () => void;
+    pause: () => void;
+    restart: () => void;
+}
+export declare const NiceParticleEditor: React.ForwardRefExoticComponent<NiceParticleEditorProps & React.RefAttributes<NiceParticleEditorRef>>;
+export default NiceParticleEditor;