Feature/tilemap editor (#237)

* feat: 添加 Tilemap 编辑器插件和组件生命周期支持

* feat(editor-core): 添加声明式插件注册 API

* feat(editor-core): 改进tiledmap结构合并tileset进tiledmapeditor

* feat: 添加 editor-runtime SDK 和插件系统改进

* fix(ci): 修复SceneResourceManager里变量未使用问题
This commit is contained in:
YHH
2025-11-25 22:23:19 +08:00
committed by GitHub
parent 551ca7805d
commit 3fb6f919f8
166 changed files with 54691 additions and 8674 deletions

View File

@@ -0,0 +1,230 @@
/**
* Layer Panel Component
* 图层面板组件
*/
import React, { useState, useCallback } from 'react';
import { Eye, EyeOff, Lock, Unlock, Plus, Trash2, ChevronUp, ChevronDown, Paintbrush } from 'lucide-react';
import { useTilemapEditorStore, type LayerState } from '../../stores/TilemapEditorStore';
import type { TilemapComponent } from '@esengine/tilemap';
interface LayerPanelProps {
tilemap: TilemapComponent | null;
onAddLayer?: () => void;
onRemoveLayer?: (index: number) => void;
onMoveLayer?: (fromIndex: number, toIndex: number) => void;
}
export const LayerPanel: React.FC<LayerPanelProps> = ({
tilemap,
onAddLayer,
onRemoveLayer,
onMoveLayer,
}) => {
const {
currentLayer,
layers,
setCurrentLayer,
toggleLayerVisibility,
toggleLayerLocked,
setLayerOpacity,
renameLayer,
} = useTilemapEditorStore();
const [editingIndex, setEditingIndex] = useState<number | null>(null);
const [editName, setEditName] = useState('');
const handleDoubleClick = useCallback((index: number, name: string) => {
setEditingIndex(index);
setEditName(name);
}, []);
const handleNameSubmit = useCallback((index: number) => {
if (editName.trim()) {
renameLayer(index, editName.trim());
// Also update the tilemap component
if (tilemap && tilemap.layers[index]) {
tilemap.layers[index].name = editName.trim();
}
}
setEditingIndex(null);
}, [editName, renameLayer, tilemap]);
const handleKeyDown = useCallback((e: React.KeyboardEvent, index: number) => {
if (e.key === 'Enter') {
handleNameSubmit(index);
} else if (e.key === 'Escape') {
setEditingIndex(null);
}
}, [handleNameSubmit]);
const handleVisibilityToggle = useCallback((index: number) => {
toggleLayerVisibility(index);
// Also update the tilemap component
if (tilemap && tilemap.layers[index]) {
tilemap.layers[index].visible = !tilemap.layers[index].visible;
tilemap.renderDirty = true;
}
}, [toggleLayerVisibility, tilemap]);
const handleOpacityChange = useCallback((index: number, opacity: number) => {
setLayerOpacity(index, opacity);
// Also update the tilemap component
if (tilemap && tilemap.layers[index]) {
tilemap.layers[index].opacity = opacity;
tilemap.renderDirty = true;
}
}, [setLayerOpacity, tilemap]);
if (!tilemap || layers.length === 0) {
return (
<div className="layer-panel">
<div className="layer-panel-header">
<span></span>
<button
className="icon-button"
onClick={onAddLayer}
title="添加图层"
>
<Plus size={14} />
</button>
</div>
<div className="layer-panel-empty">
</div>
</div>
);
}
return (
<div className="layer-panel">
<div className="layer-panel-header">
<span> ({layers.length})</span>
<div className="layer-panel-actions">
<button
className="icon-button"
onClick={onAddLayer}
title="添加图层"
>
<Plus size={14} />
</button>
</div>
</div>
<div className="layer-list">
{layers.map((layer, index) => (
<div
key={layer.id}
className={`layer-item ${index === currentLayer ? 'selected' : ''} ${layer.locked ? 'locked' : ''}`}
onClick={() => setCurrentLayer(index)}
>
<div className="layer-controls">
<button
className="icon-button small"
onClick={(e) => {
e.stopPropagation();
handleVisibilityToggle(index);
}}
title={layer.visible ? '隐藏图层' : '显示图层'}
>
{layer.visible ? <Eye size={12} /> : <EyeOff size={12} />}
</button>
<button
className="icon-button small"
onClick={(e) => {
e.stopPropagation();
toggleLayerLocked(index);
}}
title={layer.locked ? '解锁图层' : '锁定图层'}
>
{layer.locked ? <Lock size={12} /> : <Unlock size={12} />}
</button>
</div>
<div className="layer-info">
{index === currentLayer && (
<span className="layer-active-indicator" title="当前绘制图层">
<Paintbrush size={14} />
</span>
)}
{editingIndex === index ? (
<input
type="text"
value={editName}
onChange={(e) => setEditName(e.target.value)}
onBlur={() => handleNameSubmit(index)}
onKeyDown={(e) => handleKeyDown(e, index)}
autoFocus
className="layer-name-input"
onClick={(e) => e.stopPropagation()}
/>
) : (
<span
className="layer-name"
onDoubleClick={() => handleDoubleClick(index, layer.name)}
>
{layer.name}
</span>
)}
</div>
<div className="layer-actions">
<button
className="icon-button small"
onClick={(e) => {
e.stopPropagation();
onMoveLayer?.(index, index - 1);
}}
disabled={index === 0}
title="上移图层"
>
<ChevronUp size={12} />
</button>
<button
className="icon-button small"
onClick={(e) => {
e.stopPropagation();
onMoveLayer?.(index, index + 1);
}}
disabled={index === layers.length - 1}
title="下移图层"
>
<ChevronDown size={12} />
</button>
<button
className="icon-button small danger"
onClick={(e) => {
e.stopPropagation();
onRemoveLayer?.(index);
}}
disabled={layers.length <= 1}
title="删除图层"
>
<Trash2 size={12} />
</button>
</div>
</div>
))}
</div>
{/* Opacity slider for selected layer */}
{layers[currentLayer] && (
<div className="layer-opacity-control">
<label>Opacity</label>
<input
type="range"
min="0"
max="1"
step="0.01"
value={layers[currentLayer].opacity}
onChange={(e) => handleOpacityChange(currentLayer, parseFloat(e.target.value))}
title={`Opacity for ${layers[currentLayer].name}`}
/>
<span>{Math.round(layers[currentLayer].opacity * 100)}%</span>
</div>
)}
</div>
);
};
export default LayerPanel;

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,150 @@
/**
* Tileset Panel - Display tileset for selection
*/
import React, { useEffect, useCallback } from 'react';
import { Core } from '@esengine/ecs-framework';
import { MessageHub } from '@esengine/editor-core';
import { TilemapComponent, type ITilesetData } from '@esengine/tilemap';
import { useTilemapEditorStore } from '../../stores/TilemapEditorStore';
import { TilesetPreview } from '../TilesetPreview';
import '../../styles/TilemapEditor.css';
// Helper to convert file path to URL
function convertFileSrc(path: string): string {
if (path.startsWith('http://') || path.startsWith('https://') || path.startsWith('asset://')) {
return path;
}
return `asset://localhost/${encodeURIComponent(path)}`;
}
interface TilesetPanelProps {
projectPath?: string | null;
}
export const TilesetPanel: React.FC<TilesetPanelProps> = () => {
const {
entityId,
tilesetImageUrl,
tilesetColumns,
tilesetRows,
tileWidth,
tileHeight,
selectedTiles,
setTileset
} = useTilemapEditorStore();
// Load tileset from component
const loadTilesetFromComponent = useCallback(() => {
if (!entityId) return;
const scene = Core.scene;
if (!scene) return;
const foundEntity = scene.findEntityById(parseInt(entityId, 10));
if (!foundEntity) return;
const tilemapComp = foundEntity.getComponent(TilemapComponent);
if (!tilemapComp) return;
// Get tileset source from first tileset
const tilesetRef = tilemapComp.tilesets[0];
if (!tilesetRef) return;
const tilesetPath = tilesetRef.source;
const imageUrl = convertFileSrc(tilesetPath);
const currentState = useTilemapEditorStore.getState();
// Check if URL or tile dimensions changed
const urlChanged = imageUrl !== currentState.tilesetImageUrl;
const dimensionsChanged =
tilemapComp.tileWidth !== currentState.tileWidth ||
tilemapComp.tileHeight !== currentState.tileHeight;
if (!urlChanged && !dimensionsChanged) return;
const img = new Image();
img.onload = () => {
const columns = Math.floor(img.width / tilemapComp.tileWidth);
const rows = Math.floor(img.height / tilemapComp.tileHeight);
// Create tileset data and set it
const tilesetData: ITilesetData = {
name: 'tileset',
version: 1,
image: tilesetPath,
imageWidth: img.width,
imageHeight: img.height,
tileWidth: tilemapComp.tileWidth,
tileHeight: tilemapComp.tileHeight,
tileCount: columns * rows,
columns,
rows
};
tilemapComp.setTilesetData(0, tilesetData);
setTileset(imageUrl, columns, rows, tilemapComp.tileWidth, tilemapComp.tileHeight);
};
img.src = imageUrl;
}, [entityId, setTileset]);
// Load tileset when entityId is set but tilesetImageUrl is not yet loaded
useEffect(() => {
if (!entityId || tilesetImageUrl) return;
loadTilesetFromComponent();
}, [entityId, tilesetImageUrl, loadTilesetFromComponent]);
// Listen for scene modifications to reload tileset when property changes
useEffect(() => {
if (!entityId) return;
const messageHub = Core.services.resolve(MessageHub);
if (!messageHub) return;
const unsubscribe = messageHub.subscribe('scene:modified', () => {
loadTilesetFromComponent();
});
return unsubscribe;
}, [entityId, loadTilesetFromComponent]);
if (!tilesetImageUrl) {
return (
<div className="tileset-panel">
<div className="tileset-panel-header">
<h3>Tileset</h3>
</div>
<div className="tileset-empty">
<p>
No tileset loaded.
<br />
Select a TilemapComponent to edit.
</p>
</div>
</div>
);
}
return (
<div className="tileset-panel">
<div className="tileset-panel-header">
<h3>Tileset</h3>
</div>
<div className="tileset-canvas-container">
<TilesetPreview
imageUrl={tilesetImageUrl}
tileWidth={tileWidth}
tileHeight={tileHeight}
columns={tilesetColumns}
rows={tilesetRows}
/>
</div>
{selectedTiles && (
<div className="tilemap-info-bar">
<span>
Selected: {selectedTiles.width}×{selectedTiles.height}
</span>
<span>Tile: {selectedTiles.tiles[0]}</span>
</div>
)}
</div>
);
};