Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

refactor: introduce EditorPlugin system to decentralize registration

esengine04bc7fc3e0aa
diff --git a/editor/src/Editor.ts b/editor/src/Editor.ts
index c137a1c90..c8b18d7e1 100644
--- a/editor/src/Editor.ts
+++ b/editor/src/Editor.ts
@@ -17,12 +17,9 @@ import {
isBuiltinPanel,
isSaveable,
} from './panels/PanelRegistry';
-import { registerBuiltinPanels } from './panels/builtinPanels';
-import { registerBuiltinEditors } from './property/editors';
-import { registerMaterialEditors } from './property/materialEditors';
import { lockBuiltinPropertyEditors, clearExtensionPropertyEditors } from './property/PropertyEditor';
-import { registerBuiltinSchemas, lockBuiltinComponentSchemas, clearExtensionComponentSchemas } from './schemas/ComponentSchemas';
-import { initBoundsProviders, registerBoundsProvider, lockBuiltinBoundsProviders, clearExtensionBoundsProviders } from './bounds';
+import { lockBuiltinComponentSchemas, clearExtensionComponentSchemas, exposeRegistrationAPI } from './schemas/ComponentSchemas';
+import { registerBoundsProvider, lockBuiltinBoundsProviders, clearExtensionBoundsProviders } from './bounds';
import { saveSceneToFile, saveSceneToPath, loadSceneFromFile, loadSceneFromPath, hasFileHandle, clearFileHandle } from './io/SceneSerializer';
import { isAbsolutePath, joinPath, getProjectDir } from './utils/path';
import { icons } from './utils/icons';
@@ -34,9 +31,7 @@ import { getSharedRenderContext } from './renderer/SharedRenderContext';
import type { EditorAssetServer } from './asset/EditorAssetServer';
import { getAssetLibrary } from './asset/AssetLibrary';
import { setEditorInstance, getEditorContext, getEditorInstance } from './context/EditorContext';
-import { registerBuiltinMenus } from './menus';
-import { registerBuiltinGizmos, registerGizmo, lockBuiltinGizmos, clearExtensionGizmos } from './gizmos';
-import { registerBuiltinStatusbarItems } from './menus/builtinStatusbar';
+import { registerGizmo, lockBuiltinGizmos, clearExtensionGizmos } from './gizmos';
import { ExtensionLoader } from './extension';
import { setEditorAPI, clearEditorAPI } from './extension/editorAPI';
import {
@@ -49,7 +44,6 @@ import { showToast, showSuccessToast, showErrorToast } from './ui/Toast';
import { showContextMenu } from './ui/ContextMenu';
import { registerContextMenuItem, lockBuiltinContextMenuItems, clearExtensionContextMenuItems } from './ui/ContextMenuRegistry';
import { installGlobalErrorHandler } from './error/GlobalErrorHandler';
-import { registerBuiltinAssetTypes } from './asset/AssetTypeRegistry';
import { EditorLogger, createConsoleHandler, createToastHandler } from './logging';
import {
registerInspectorSection,
@@ -57,13 +51,13 @@ import {
lockBuiltinInspectorExtensions,
clearExtensionInspectorExtensions,
} from './panels/inspector/InspectorRegistry';
-import { registerPostProcessVolumeInspector } from './panels/inspector/PostProcessVolumeInspector';
+import type { EditorPlugin, EditorPluginContext } from './plugins/EditorPlugin';
+import { builtinPlugins, coreStatusbarPlugin } from './plugins';
import { showConfirmDialog, showInputDialog, showDialog } from './ui/dialog';
import { getEditorStore } from './store';
import { generateUniqueName } from './utils/naming';
import {
- registerBuiltinSettings,
lockBuiltinSettings,
clearExtensionSettings,
showSettingsDialog,
@@ -120,6 +114,9 @@ export class Editor {
private settingsSync_: ProjectSettingsSync | null = null;
private mainWindowBridge_: MainWindowBridge | null = null;
private windowManager_: WindowManager | null = null;
+ private plugins_: EditorPlugin[] = [];
+ private pluginNames_ = new Set<string>();
+ private pluginContext_!: EditorPluginContext;
constructor(container: HTMLElement, options?: EditorOptions) {
this.container_ = container;
@@ -131,6 +128,12 @@ export class Editor {
this.menuManager_.setStore(this.store_);
this.previewManager_ = new PreviewManager(this.projectPath_);
+ this.pluginContext_ = {
+ editor: this,
+ projectPath: this.projectPath_,
+ onOpenScene: (path: string) => this.openSceneFromPath(path),
+ };
+
installGlobalErrorHandler();
EditorLogger.addHandler(createConsoleHandler());
@@ -140,20 +143,10 @@ export class Editor {
}));
EditorLogger.setMinLevel('info');
- registerBuiltinAssetTypes();
- registerBuiltinEditors();
- registerMaterialEditors();
- registerBuiltinSchemas();
- registerPostProcessVolumeInspector();
- initBoundsProviders();
- registerBuiltinGizmos();
- registerBuiltinSettings();
-
- registerBuiltinPanels({
- projectPath: this.projectPath_ ?? undefined,
- onOpenScene: (scenePath) => this.openSceneFromPath(scenePath),
- });
- registerBuiltinMenus(this);
+ for (const plugin of builtinPlugins) {
+ this.addPlugin(plugin);
+ }
+ exposeRegistrationAPI();
lockBuiltinPanels();
lockBuiltinMenus();
lockBuiltinGizmos();
@@ -166,7 +159,7 @@ export class Editor {
this.setupLayout();
- registerBuiltinStatusbarItems(this);
+ this.addPlugin(coreStatusbarPlugin);
this.menuManager_.instantiateStatusbar(this.container_);
this.menuManager_.setupMenuShortcuts();
this.menuManager_.attach();
@@ -182,6 +175,21 @@ export class Editor {
}
}
+ addPlugin(plugin: EditorPlugin): this {
+ if (this.pluginNames_.has(plugin.name)) return this;
+ if (plugin.dependencies) {
+ for (const dep of plugin.dependencies) {
+ if (!this.pluginNames_.has(dep)) {
+ throw new Error(`Plugin "${plugin.name}" requires "${dep}"`);
+ }
+ }
+ }
+ plugin.register(this.pluginContext_);
+ this.plugins_.push(plugin);
+ this.pluginNames_.add(plugin.name);
+ return this;
+ }
+
get projectPath(): string | null {
return this.projectPath_;
}
diff --git a/editor/src/asset/AssetTypeRegistry.ts b/editor/src/asset/AssetTypeRegistry.ts
index 8bbfa0d87..068d7a955 100644
--- a/editor/src/asset/AssetTypeRegistry.ts
+++ b/editor/src/asset/AssetTypeRegistry.ts
@@ -16,6 +16,7 @@ import { getGlobalPathResolver } from '../asset';
import { getPlatformAdapter } from '../platform/PlatformAdapter';
import { getEditorContext } from '../context/EditorContext';
import { getAssetDatabase } from './AssetDatabase';
+import { AssetType } from '../constants/AssetTypes';
export type AssetPayload = { type: string; path: string; name: string };
@@ -188,9 +189,9 @@ async function createSpineEntityFromAsset(
// =========================================================================
export function registerBuiltinAssetTypes(): void {
- registerAssetType('image', {
+ registerAssetType(AssetType.IMAGE, {
editorType: 'texture',
- displayType: 'image',
+ displayType: AssetType.IMAGE,
displayName: 'Image',
icon: icons.image,
eventCategory: 'texture',
@@ -236,9 +237,9 @@ export function registerBuiltinAssetTypes(): void {
},
});
- registerAssetType('material', {
+ registerAssetType(AssetType.MATERIAL, {
editorType: 'material',
- displayType: 'material',
+ displayType: AssetType.MATERIAL,
displayName: 'Material',
icon: icons.settings,
eventCategory: 'material',
@@ -247,9 +248,9 @@ export function registerBuiltinAssetTypes(): void {
createMenuEntry: null,
});
- registerAssetType('shader', {
+ registerAssetType(AssetType.SHADER, {
editorType: 'shader',
- displayType: 'shader',
+ displayType: AssetType.SHADER,
displayName: 'Shader',
icon: icons.code,
eventCategory: 'shader',
@@ -258,9 +259,9 @@ export function registerBuiltinAssetTypes(): void {
createMenuEntry: null,
});
- registerAssetType('font', {
+ registerAssetType(AssetType.FONT, {
editorType: 'bitmap-font',
- displayType: 'font',
+ displayType: AssetType.FONT,
displayName: 'BitmapFont',
icon: icons.type,
eventCategory: null,
@@ -269,9 +270,9 @@ export function registerBuiltinAssetTypes(): void {
createMenuEntry: null,
});
- registerAssetType('spine', {
+ registerAssetType(AssetType.SPINE, {
editorType: ['spine-atlas', 'spine-skeleton'],
- displayType: 'spine',
+ displayType: AssetType.SPINE,
displayName: 'Spine',
icon: icons.bone,
eventCategory: 'spine',
@@ -281,9 +282,9 @@ export function registerBuiltinAssetTypes(): void {
onCreateEntity: createSpineEntityFromAsset,
});
- registerAssetType('animclip', {
+ registerAssetType(AssetType.ANIMCLIP, {
editorType: 'anim-clip',
- displayType: 'animclip',
+ displayType: AssetType.ANIMCLIP,
displayName: 'Animation Clip',
icon: icons.film,
eventCategory: 'anim-clip',
@@ -319,9 +320,9 @@ export function registerBuiltinAssetTypes(): void {
},
});
- registerAssetType('timeline', {
+ registerAssetType(AssetType.TIMELINE, {
editorType: 'timeline',
- displayType: 'timeline',
+ displayType: AssetType.TIMELINE,
displayName: 'Timeline',
icon: icons.film,
eventCategory: null,
@@ -330,9 +331,9 @@ export function registerBuiltinAssetTypes(): void {
createMenuEntry: null,
});
- registerAssetType('scene', {
+ registerAssetType(AssetType.SCENE, {
editorType: 'scene',
- displayType: 'scene',
+ displayType: AssetType.SCENE,
displayName: 'Scene',
icon: icons.layers,
eventCategory: null,
@@ -341,9 +342,9 @@ export function registerBuiltinAssetTypes(): void {
createMenuEntry: null,
});
- registerAssetType('prefab', {
+ registerAssetType(AssetType.PREFAB, {
editorType: 'prefab',
- displayType: 'prefab',
+ displayType: AssetType.PREFAB,
displayName: 'Prefab',
icon: icons.package,
eventCategory: null,
@@ -357,9 +358,9 @@ export function registerBuiltinAssetTypes(): void {
},
});
- registerAssetType('audio', {
+ registerAssetType(AssetType.AUDIO, {
editorType: 'audio',
- displayType: 'audio',
+ displayType: AssetType.AUDIO,
displayName: 'Audio',
icon: icons.volume,
eventCategory: null,
@@ -391,9 +392,9 @@ export function registerBuiltinAssetTypes(): void {
},
});
- registerAssetType('script', {
+ registerAssetType(AssetType.SCRIPT, {
editorType: 'script',
- displayType: 'script',
+ displayType: AssetType.SCRIPT,
displayName: 'Script',
icon: icons.code,
eventCategory: null,
@@ -402,9 +403,9 @@ export function registerBuiltinAssetTypes(): void {
createMenuEntry: null,
});
- registerAssetType('json', {
+ registerAssetType(AssetType.JSON, {
editorType: 'json',
- displayType: 'json',
+ displayType: AssetType.JSON,
displayName: 'JSON',
icon: icons.braces,
eventCategory: null,
@@ -414,9 +415,9 @@ export function registerBuiltinAssetTypes(): void {
onCreateEntity: createSpineEntityFromAsset,
});
- registerAssetType('folder', {
+ registerAssetType(AssetType.FOLDER, {
editorType: 'folder',
- displayType: 'folder',
+ displayType: AssetType.FOLDER,
displayName: 'Folder',
icon: icons.folder,
eventCategory: null,
@@ -425,9 +426,9 @@ export function registerBuiltinAssetTypes(): void {
createMenuEntry: null,
});
- registerAssetType('file', {
+ registerAssetType(AssetType.FILE, {
editorType: 'file',
- displayType: 'file',
+ displayType: AssetType.FILE,
displayName: 'File',
icon: icons.file,
eventCategory: null,
diff --git a/editor/src/bounds/index.ts b/editor/src/bounds/index.ts
index 58f0c90f3..3068e4b5d 100644
--- a/editor/src/bounds/index.ts
+++ b/editor/src/bounds/index.ts
@@ -5,16 +5,3 @@
export * from './BoundsProvider';
export { registerBoundsProvider, getEntityBounds, lockBuiltinBoundsProviders, clearExtensionBoundsProviders } from './BoundsRegistry';
-
-import { registerBoundsProvider } from './BoundsRegistry';
-import { spriteBoundsProvider } from './SpriteBoundsProvider';
-import { textBoundsProvider } from './TextBoundsProvider';
-import { uiRectBoundsProvider } from './UIRectBoundsProvider';
-import { spineAnimationBoundsProvider } from './SpineAnimationBoundsProvider';
-
-export function initBoundsProviders(): void {
- registerBoundsProvider('UIRect', uiRectBoundsProvider);
- registerBoundsProvider('Sprite', spriteBoundsProvider);
- registerBoundsProvider('Text', textBoundsProvider);
- registerBoundsProvider('SpineAnimation', spineAnimationBoundsProvider);
-}
diff --git a/editor/src/constants/AssetTypes.ts b/editor/src/constants/AssetTypes.ts
new file mode 100644
index 000000000..cf3798315
--- /dev/null
+++ b/editor/src/constants/AssetTypes.ts
@@ -0,0 +1,19 @@
+export const AssetType = {
+ IMAGE: 'image',
+ MATERIAL: 'material',
+ SHADER: 'shader',
+ FONT: 'font',
+ SPINE: 'spine',
+ ANIMCLIP: 'animclip',
+ TIMELINE: 'timeline',
+ SCENE: 'scene',
+ PREFAB: 'prefab',
+ AUDIO: 'audio',
+ SCRIPT: 'script',
+ JSON: 'json',
+ FOLDER: 'folder',
+ FILE: 'file',
+ TILEMAP: 'tilemap',
+} as const;
+
+export type AssetTypeValue = typeof AssetType[keyof typeof AssetType];
diff --git a/editor/src/gizmos/ColliderOverlay.ts b/editor/src/gizmos/ColliderOverlay.ts
index 5c82c2aa4..0e0a86296 100644
--- a/editor/src/gizmos/ColliderOverlay.ts
+++ b/editor/src/gizmos/ColliderOverlay.ts
@@ -4,10 +4,10 @@
*/
import type { Entity } from 'esengine';
-import { DEFAULT_PIXELS_PER_UNIT } from 'esengine';
import type { EditorStore } from '../store/EditorStore';
import type { EntityData, ComponentData } from '../types/SceneTypes';
import { quatToEuler } from '../math/Transform';
+import { findScenePixelsPerUnit } from '../utils/sceneQueries';
const COLLIDER_COLOR = 'rgba(0, 255, 100, 0.3)';
const COLLIDER_COLOR_SELECTED = 'rgba(0, 255, 100, 0.8)';
@@ -93,7 +93,7 @@ export class ColliderOverlay {
if (!this.dragState_) return;
const { store } = octx;
- const ppu = this.getPixelsPerUnit(store);
+ const ppu = findScenePixelsPerUnit(store.scene.entities);
const { entity, componentType, handleId, startWorldX, startWorldY } = this.dragState_;
const comp = store.getComponent(entity, componentType);
if (!comp) return;
@@ -201,7 +201,7 @@ export class ColliderOverlay {
const entityData = store.getSelectedEntityData();
if (!entityData) return false;
- const ppu = this.getPixelsPerUnit(store);
+ const ppu = findScenePixelsPerUnit(store.scene.entities);
const worldTransform = store.getWorldTransform(entityData.id);
const pos = worldTransform.position;
const scale = worldTransform.scale;
@@ -333,7 +333,7 @@ export class ColliderOverlay {
private drawEntityColliders(octx: OverlayContext, entity: EntityData, isSelected: boolean): void {
const { ctx, zoom, store } = octx;
- const ppu = this.getPixelsPerUnit(store);
+ const ppu = findScenePixelsPerUnit(store.scene.entities);
const worldTransform = store.getWorldTransform(entity.id);
const pos = worldTransform.position;
const scale = worldTransform.scale;
@@ -634,7 +634,7 @@ export class ColliderOverlay {
entityData: EntityData
): { componentType: string; handleId: HandleId } | null {
const { zoom, store } = octx;
- const ppu = this.getPixelsPerUnit(store);
+ const ppu = findScenePixelsPerUnit(store.scene.entities);
const worldTransform = store.getWorldTransform(entityData.id);
const pos = worldTransform.position;
const scale = worldTransform.scale;
@@ -751,16 +751,6 @@ export class ColliderOverlay {
return null;
}
- private getPixelsPerUnit(store: EditorStore): number {
- for (const entity of store.scene.entities) {
- for (const comp of entity.components) {
- if (comp.type === 'Canvas') {
- return (comp.data.pixelsPerUnit as number) || DEFAULT_PIXELS_PER_UNIT;
- }
- }
- }
- return DEFAULT_PIXELS_PER_UNIT;
- }
private cloneColliderData(comp: ComponentData): Record<string, unknown> {
const result: Record<string, unknown> = {};
diff --git a/editor/src/gizmos/ParticleOverlay.ts b/editor/src/gizmos/ParticleOverlay.ts
index b343e2663..85464df41 100644
--- a/editor/src/gizmos/ParticleOverlay.ts
+++ b/editor/src/gizmos/ParticleOverlay.ts
@@ -3,11 +3,11 @@
* @brief Overlay for particle emitter shape visualization
*/
-import { DEFAULT_PIXELS_PER_UNIT } from 'esengine';
import type { EditorStore } from '../store/EditorStore';
import type { EntityData } from '../types/SceneTypes';
import { quatToEuler } from '../math/Transform';
import type { OverlayContext } from './ColliderOverlay';
+import { findScenePixelsPerUnit } from '../utils/sceneQueries';
const PARTICLE_COLOR = 'rgba(255, 165, 0, 0.8)';
const PARTICLE_FILL = 'rgba(255, 165, 0, 0.15)';
@@ -40,7 +40,7 @@ export class ParticleOverlay {
if (!comp) return;
const { ctx, zoom, store } = octx;
- const ppu = this.getPixelsPerUnit(store);
+ const ppu = findScenePixelsPerUnit(store.scene.entities);
const worldTransform = store.getWorldTransform(entity.id);
const pos = worldTransform.position;
const scale = worldTransform.scale;
@@ -160,14 +160,4 @@ export class ParticleOverlay {
ctx.fill();
}
- private getPixelsPerUnit(store: EditorStore): number {
- for (const entity of store.scene.entities) {
- for (const comp of entity.components) {
- if (comp.type === 'Canvas') {
- return (comp.data.pixelsPerUnit as number) || DEFAULT_PIXELS_PER_UNIT;
- }
- }
- }
- return DEFAULT_PIXELS_PER_UNIT;
- }
}
diff --git a/editor/src/gizmos/builtinGizmos.ts b/editor/src/gizmos/builtinGizmos.ts
index 25fc69a26..d7528dfb9 100644
--- a/editor/src/gizmos/builtinGizmos.ts
+++ b/editor/src/gizmos/builtinGizmos.ts
@@ -2,6 +2,7 @@ import { registerGizmo, type GizmoContext, type GizmoDescriptor } from './GizmoR
import { icons } from '../utils/icons';
import { quatToEuler, eulerToQuat } from '../math/Transform';
import { getSettingsValue } from '../settings/SettingsRegistry';
+import { getSizeProvider } from '../utils/sceneQueries';
function getGizmoColors() {
return {
@@ -41,11 +42,6 @@ function valuesEqual(a: unknown, b: unknown): boolean {
return JSON.stringify(a) === JSON.stringify(b);
}
-function getSizeComponentType(entityData: { components: { type: string; data: any }[] }): 'UIRect' | 'Sprite' | null {
- if (entityData.components.some(c => c.type === 'UIRect')) return 'UIRect';
- if (entityData.components.some(c => c.type === 'Sprite')) return 'Sprite';
- return null;
-}
function hitTestEntityBounds(worldX: number, worldY: number, gctx: GizmoContext): boolean {
const entityData = gctx.store.getSelectedEntityData();
@@ -690,7 +686,7 @@ export function createRectGizmo(): GizmoDescriptor {
const transform = entityData.components.find(c => c.type === 'Transform');
const pos = transform?.data.position as { x: number; y: number; z: number } ?? { x: 0, y: 0, z: 0 };
- const sizeType = getSizeComponentType(entityData);
+ const sizeType = getSizeProvider(entityData);
let size: { x: number; y: number };
if (sizeType) {
const comp = entityData.components.find(c => c.type === sizeType);
@@ -739,7 +735,7 @@ export function createRectGizmo(): GizmoDescriptor {
newWidth = Math.max(1, newWidth);
newHeight = Math.max(1, newHeight);
- const sizeType = getSizeComponentType(entityData);
+ const sizeType = getSizeProvider(entityData);
if (sizeType) {
gctx.store.updatePropertyDirect(entity, sizeType, 'size', { x: newWidth, y: newHeight });
}
@@ -762,7 +758,7 @@ export function createRectGizmo(): GizmoDescriptor {
const entityData = gctx.store.getSelectedEntityData();
if (!entityData) { dragState = null; return; }
- const sizeType = getSizeComponentType(entityData);
+ const sizeType = getSizeProvider(entityData);
if (sizeType) {
const comp = entityData.components.find(c => c.type === sizeType)!;
const currentSize = comp.data.size as { x: number; y: number };
diff --git a/editor/src/panels/builtinPanels.ts b/editor/src/panels/builtinPanels.ts
index 4157050d9..53da95062 100644
--- a/editor/src/panels/builtinPanels.ts
+++ b/editor/src/panels/builtinPanels.ts
@@ -9,6 +9,8 @@ import { ProfilerPanel } from './profiler/ProfilerPanel';
import { TimelinePanel } from './timeline/TimelinePanel';
import { icons } from '../utils/icons';
+const PANEL_ICON_SIZE = 14;
+
export interface BuiltinPanelOptions {
projectPath?: string;
onOpenScene?: (path: string) => void;
@@ -18,7 +20,7 @@ export function registerBuiltinPanels(options: BuiltinPanelOptions): void {
registerPanel({
id: 'hierarchy',
title: 'Hierarchy',
- icon: icons.list(14),
+ icon: icons.list(PANEL_ICON_SIZE),
position: 'left',
order: 0,
defaultVisible: true,
@@ -37,7 +39,7 @@ export function registerBuiltinPanels(options: BuiltinPanelOptions): void {
registerPanel({
id: 'game',
title: 'Game',
- icon: icons.play(14),
+ icon: icons.play(PANEL_ICON_SIZE),
position: 'center',
order: 2,
defaultVisible: true,
@@ -47,7 +49,7 @@ export function registerBuiltinPanels(options: BuiltinPanelOptions): void {
registerPanel({
id: 'inspector',
title: 'Inspector',
- icon: icons.settings(14),
+ icon: icons.settings(PANEL_ICON_SIZE),
position: 'right',
order: 0,
defaultVisible: true,
@@ -57,7 +59,7 @@ export function registerBuiltinPanels(options: BuiltinPanelOptions): void {
registerPanel({
id: 'content-browser',
title: 'Content Browser',
- icon: icons.folder(14),
+ icon: icons.folder(PANEL_ICON_SIZE),
position: 'bottom',
order: 0,
defaultVisible: true,
@@ -70,7 +72,7 @@ export function registerBuiltinPanels(options: BuiltinPanelOptions): void {
registerPanel({
id: 'output',
title: 'Output',
- icon: icons.list(14),
+ icon: icons.list(PANEL_ICON_SIZE),
position: 'bottom',
order: 1,
defaultVisible: false,
@@ -80,7 +82,7 @@ export function registerBuiltinPanels(options: BuiltinPanelOptions): void {
registerPanel({
id: 'timeline',
title: 'Timeline',
- icon: icons.film(14),
+ icon: icons.film(PANEL_ICON_SIZE),
position: 'bottom',
order: 2,
defaultVisible: false,
@@ -90,7 +92,7 @@ export function registerBuiltinPanels(options: BuiltinPanelOptions): void {
registerPanel({
id: 'profiler',
title: 'Profiler',
- icon: icons.gauge(14),
+ icon: icons.gauge(PANEL_ICON_SIZE),
position: 'bottom',
detachOnly: true,
order: 99,
diff --git a/editor/src/panels/content-browser/AssetContextMenu.ts b/editor/src/panels/content-browser/AssetContextMenu.ts
index 4641c95ee..aee2192d3 100644
--- a/editor/src/panels/content-browser/AssetContextMenu.ts
+++ b/editor/src/panels/content-browser/AssetContextMenu.ts
@@ -11,6 +11,7 @@ import { getSettingsValue } from '../../settings';
import { DEFAULT_DESIGN_WIDTH, DEFAULT_DESIGN_HEIGHT } from 'esengine';
import type { AssetItem, ContentBrowserState } from './ContentBrowserTypes';
import { getNativeFS } from './ContentBrowserTypes';
+import { AssetType } from '../../constants/AssetTypes';
import { getGlobalPathResolver } from '../../asset';
export function showAssetContextMenu(state: ContentBrowserState, e: MouseEvent, path: string, type: AssetItem['type']): void {
@@ -62,7 +63,7 @@ export function showMultiSelectContextMenu(state: ContentBrowserState, e: MouseE
];
const selectedItems = state.filteredItems.filter(item => state.selectedPaths.has(item.path));
- const allImages = selectedItems.length > 0 && selectedItems.every(item => item.type === 'image');
+ const allImages = selectedItems.length > 0 && selectedItems.every(item => item.type === AssetType.IMAGE);
if (allImages) {
items.push(
{ label: '', separator: true },
diff --git a/editor/src/panels/content-browser/AssetGrid.ts b/editor/src/panels/content-browser/AssetGrid.ts
index 8ac46ac4e..30f760135 100644
--- a/editor/src/panels/content-browser/AssetGrid.ts
+++ b/editor/src/panels/content-browser/AssetGrid.ts
@@ -2,6 +2,7 @@ import { icons } from '../../utils/icons';
import { joinPath } from '../../utils/path';
import type { AssetItem, ContentBrowserState } from './ContentBrowserTypes';
import { getNativeFS, getAssetType, getAssetIcon, isImageFile, SEARCH_RESULTS_LIMIT } from './ContentBrowserTypes';
+import { AssetType } from '../../constants/AssetTypes';
import type { ThumbnailCache } from './ThumbnailCache';
import { searchRecursive } from './AssetSearch';
import { findFolder } from './FolderTree';
@@ -75,7 +76,7 @@ export async function renderGrid(state: ContentBrowserState, thumbnailCache: Thu
}
for (const item of filteredItems) {
- if (item.type === 'image' && isImageFile(item.name)) {
+ if (item.type === AssetType.IMAGE && isImageFile(item.name)) {
loadThumbnailFor(state, item.path, thumbnailCache);
}
}
@@ -89,7 +90,7 @@ export async function renderGrid(state: ContentBrowserState, thumbnailCache: Thu
}
function getItemIconHtml(item: AssetItem, size: number, thumbnailCache: ThumbnailCache): string {
- if (item.type === 'image' && isImageFile(item.name)) {
+ if (item.type === AssetType.IMAGE && isImageFile(item.name)) {
const cached = thumbnailCache.get(item.path);
if (cached) {
return `<img src="${cached}" width="${size}" height="${size}" class="es-cb-thumbnail" alt="">`;
diff --git a/editor/src/panels/inspector/AnimClipInspector.ts b/editor/src/panels/inspector/AnimClipInspector.ts
index 452970422..e07fb862f 100644
--- a/editor/src/panels/inspector/AnimClipInspector.ts
+++ b/editor/src/panels/inspector/AnimClipInspector.ts
@@ -3,6 +3,7 @@ import { getNativeFS, getFileName, renderError, getAssetServer } from './Inspect
import { getPlatformAdapter } from '../../platform/PlatformAdapter';
import { getGlobalPathResolver } from '../../asset';
import { getAssetDatabase, isUUID } from '../../asset/AssetDatabase';
+import { AssetType } from '../../constants/AssetTypes';
interface AnimClipAssetData {
version: string;
@@ -225,7 +226,7 @@ function setupDropZone(
return;
}
- const imageAssets = assets.filter(a => a.type === 'image');
+ const imageAssets = assets.filter(a => a.type === AssetType.IMAGE);
if (imageAssets.length === 0) return;
const resolver = getGlobalPathResolver();
diff --git a/editor/src/panels/inspector/SharedEditors.ts b/editor/src/panels/inspector/SharedEditors.ts
index f5c5f83a0..a6c96846d 100644
--- a/editor/src/panels/inspector/SharedEditors.ts
+++ b/editor/src/panels/inspector/SharedEditors.ts
@@ -5,9 +5,10 @@
import type { ShaderProperty } from '../../shader/ShaderPropertyParser';
import { ShaderPropertyType, getDefaultPropertyValue } from '../../shader/ShaderPropertyParser';
-import { getPlatformAdapter } from '../../platform/PlatformAdapter';
-import { getProjectDir, openAssetInBrowser } from './InspectorHelpers';
+import { openAssetInBrowser } from './InspectorHelpers';
import { setupDragLabel } from '../../property/editorUtils';
+import { handleAssetDrop, browseForAsset, BROWSE_ICON } from '../../property/editors';
+import { AssetType } from '../../constants/AssetTypes';
// =============================================================================
// Numeric Editors
@@ -302,75 +303,22 @@ export function createTextureEditor(container: HTMLElement, value: string, onCha
const browseBtn = document.createElement('button');
browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
+ browseBtn.innerHTML = BROWSE_ICON;
input.addEventListener('click', () => {
- if (input.value) {
- openAssetInBrowser(input.value);
- }
- });
-
- wrapper.addEventListener('dragover', (e) => {
- e.preventDefault();
- const data = e.dataTransfer?.types.includes('application/esengine-asset');
- if (data) {
- wrapper.classList.add('es-drag-over');
- e.dataTransfer!.dropEffect = 'copy';
- } else {
- e.dataTransfer!.dropEffect = 'none';
- }
+ if (input.value) openAssetInBrowser(input.value);
});
- wrapper.addEventListener('dragleave', () => {
- wrapper.classList.remove('es-drag-over');
- });
-
- wrapper.addEventListener('drop', (e) => {
- e.preventDefault();
- wrapper.classList.remove('es-drag-over');
-
- const jsonData = e.dataTransfer?.getData('application/esengine-asset');
- if (!jsonData) return;
-
- try {
- const assetData = JSON.parse(jsonData);
- if (assetData.type === 'image') {
- const projectDir = getProjectDir();
- if (projectDir && assetData.path.startsWith(projectDir)) {
- const relativePath = assetData.path.substring(projectDir.length + 1);
- input.value = relativePath;
- onChange(relativePath);
- }
- }
- } catch (err) {
- console.error('Failed to parse drop data:', err);
- }
+ handleAssetDrop(wrapper, [AssetType.IMAGE], (relativePath) => {
+ input.value = relativePath;
+ onChange(relativePath);
});
browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
-
- const assetsDir = `${projectDir}/assets`;
-
- try {
- const platform = getPlatformAdapter();
- const result = await platform.openFileDialog({
- title: 'Select Texture',
- defaultPath: assetsDir,
- filters: [{ name: 'Images', extensions: ['png', 'jpg', 'jpeg', 'webp'] }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- input.value = relativePath;
- onChange(relativePath);
- }
- }
- } catch (err) {
- console.error('Failed to open file dialog:', err);
+ const result = await browseForAsset('Select Texture', 'Images', ['png', 'jpg', 'jpeg', 'webp']);
+ if (result) {
+ input.value = result.relativePath;
+ onChange(result.relativePath);
}
});
@@ -438,75 +386,22 @@ export function createShaderFileInput(
const browseBtn = document.createElement('button');
browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
+ browseBtn.innerHTML = BROWSE_ICON;
input.addEventListener('click', () => {
- if (input.value) {
- openAssetInBrowser(input.value);
- }
- });
-
- wrapper.addEventListener('dragover', (e) => {
- e.preventDefault();
- const data = e.dataTransfer?.types.includes('application/esengine-asset');
- if (data) {
- wrapper.classList.add('es-drag-over');
- e.dataTransfer!.dropEffect = 'copy';
- } else {
- e.dataTransfer!.dropEffect = 'none';
- }
+ if (input.value) openAssetInBrowser(input.value);
});
- wrapper.addEventListener('dragleave', () => {
- wrapper.classList.remove('es-drag-over');
- });
-
- wrapper.addEventListener('drop', (e) => {
- e.preventDefault();
- wrapper.classList.remove('es-drag-over');
-
- const jsonData = e.dataTransfer?.getData('application/esengine-asset');
- if (!jsonData) return;
-
- try {
- const assetData = JSON.parse(jsonData);
- if (assetData.type === 'shader') {
- const projectDir = getProjectDir();
- if (projectDir && assetData.path.startsWith(projectDir)) {
- const relativePath = assetData.path.substring(projectDir.length + 1);
- input.value = relativePath;
- onChange(relativePath);
- }
- }
- } catch (err) {
- console.error('Failed to parse drop data:', err);
- }
+ handleAssetDrop(wrapper, [AssetType.SHADER], (relativePath) => {
+ input.value = relativePath;
+ onChange(relativePath);
});
browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
-
- const assetsDir = `${projectDir}/assets`;
-
- try {
- const platform = getPlatformAdapter();
- const result = await platform.openFileDialog({
- title: 'Select Shader',
- defaultPath: assetsDir,
- filters: [{ name: 'Shader Files', extensions: ['esshader'] }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- input.value = relativePath;
- onChange(relativePath);
- }
- }
- } catch (err) {
- console.error('Failed to open file dialog:', err);
+ const result = await browseForAsset('Select Shader', 'Shader Files', ['esshader']);
+ if (result) {
+ input.value = result.relativePath;
+ onChange(result.relativePath);
}
});
diff --git a/editor/src/plugins/EditorPlugin.ts b/editor/src/plugins/EditorPlugin.ts
new file mode 100644
index 000000000..ab7eb5f61
--- /dev/null
+++ b/editor/src/plugins/EditorPlugin.ts
@@ -0,0 +1,13 @@
+import type { Editor } from '../Editor';
+
+export interface EditorPluginContext {
+ editor: Editor;
+ projectPath: string | null;
+ onOpenScene: (path: string) => void;
+}
+
+export interface EditorPlugin {
+ name: string;
+ dependencies?: string[];
+ register(ctx: EditorPluginContext): void;
+}
diff --git a/editor/src/plugins/animation.ts b/editor/src/plugins/animation.ts
new file mode 100644
index 000000000..534912b80
--- /dev/null
+++ b/editor/src/plugins/animation.ts
@@ -0,0 +1,22 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+import { TIME_SCALE_MAX } from '../schemas/schemaConstants';
+
+const SpriteAnimatorSchema: ComponentSchema = {
+ name: 'SpriteAnimator',
+ category: 'builtin',
+ properties: [
+ { name: 'clip', type: 'anim-file' },
+ { name: 'speed', type: 'number', min: 0, max: TIME_SCALE_MAX, step: 0.1 },
+ { name: 'playing', type: 'boolean' },
+ { name: 'loop', type: 'boolean' },
+ { name: 'enabled', type: 'boolean' },
+ ],
+};
+
+export const animationPlugin: EditorPlugin = {
+ name: 'animation',
+ register() {
+ registerComponentSchema(SpriteAnimatorSchema);
+ },
+};
diff --git a/editor/src/plugins/assetInfra.ts b/editor/src/plugins/assetInfra.ts
new file mode 100644
index 000000000..8aa4b0d8d
--- /dev/null
+++ b/editor/src/plugins/assetInfra.ts
@@ -0,0 +1,9 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerBuiltinAssetTypes } from '../asset/AssetTypeRegistry';
+
+export const assetInfraPlugin: EditorPlugin = {
+ name: 'asset-infra',
+ register() {
+ registerBuiltinAssetTypes();
+ },
+};
diff --git a/editor/src/plugins/audio.ts b/editor/src/plugins/audio.ts
new file mode 100644
index 000000000..1fc3b84c1
--- /dev/null
+++ b/editor/src/plugins/audio.ts
@@ -0,0 +1,36 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+
+const AudioSourceSchema: ComponentSchema = {
+ name: 'AudioSource',
+ category: 'builtin',
+ properties: [
+ { name: 'clip', type: 'audio-file' },
+ { name: 'bus', type: 'enum', options: [{ label: 'SFX', value: 'sfx' }, { label: 'Music', value: 'music' }, { label: 'UI', value: 'ui' }, { label: 'Voice', value: 'voice' }] },
+ { name: 'volume', type: 'number', min: 0, max: 1, step: 0.05 },
+ { name: 'pitch', type: 'number', min: 0.1, max: 3, step: 0.1 },
+ { name: 'loop', type: 'boolean' },
+ { name: 'playOnAwake', type: 'boolean' },
+ { name: 'spatial', type: 'boolean' },
+ { name: 'minDistance', type: 'number', min: 0, step: 10 },
+ { name: 'maxDistance', type: 'number', min: 0, step: 10 },
+ { name: 'attenuationModel', type: 'enum', options: [{ label: 'Linear', value: 0 }, { label: 'Inverse', value: 1 }, { label: 'Exponential', value: 2 }] },
+ { name: 'rolloff', type: 'number', min: 0, max: 5, step: 0.1 },
+ { name: 'priority', type: 'number', min: 0, step: 1 },
+ { name: 'enabled', type: 'boolean' },
+ ],
+};
+
+const AudioListenerSchema: ComponentSchema = {
+ name: 'AudioListener',
+ category: 'builtin',
+ properties: [{ name: 'enabled', type: 'boolean' }],
+};
+
+export const audioPlugin: EditorPlugin = {
+ name: 'audio',
+ register() {
+ registerComponentSchema(AudioSourceSchema);
+ registerComponentSchema(AudioListenerSchema);
+ },
+};
diff --git a/editor/src/plugins/coreComponents.ts b/editor/src/plugins/coreComponents.ts
new file mode 100644
index 000000000..bd50fcb9a
--- /dev/null
+++ b/editor/src/plugins/coreComponents.ts
@@ -0,0 +1,131 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+
+const NameSchema: ComponentSchema = {
+ name: 'Name',
+ category: 'builtin',
+ removable: false,
+ properties: [
+ { name: 'value', type: 'string' },
+ ],
+};
+
+const ParentSchema: ComponentSchema = {
+ name: 'Parent',
+ category: 'builtin',
+ removable: false,
+ properties: [
+ { name: 'entity', type: 'entity' },
+ ],
+};
+
+const ChildrenSchema: ComponentSchema = {
+ name: 'Children',
+ category: 'tag',
+ removable: false,
+ properties: [],
+};
+
+const TransformSchema: ComponentSchema = {
+ name: 'Transform',
+ category: 'builtin',
+ removable: false,
+ properties: [
+ { name: 'position', type: 'vec3' },
+ { name: 'rotation', type: 'euler' },
+ { name: 'scale', type: 'vec3' },
+ ],
+};
+
+const VelocitySchema: ComponentSchema = {
+ name: 'Velocity',
+ category: 'builtin',
+ properties: [
+ { name: 'linear', type: 'vec3' },
+ { name: 'angular', type: 'vec3' },
+ ],
+};
+
+const SceneOwnerSchema: ComponentSchema = {
+ name: 'SceneOwner',
+ category: 'builtin',
+ removable: false,
+ properties: [
+ { name: 'scene', type: 'string' },
+ { name: 'persistent', type: 'boolean' },
+ ],
+};
+
+const CanvasSchema: ComponentSchema = {
+ name: 'Canvas',
+ category: 'builtin',
+ properties: [
+ { name: 'designResolution', type: 'vec2' },
+ { name: 'pixelsPerUnit', type: 'number', min: 1, step: 1 },
+ {
+ name: 'scaleMode',
+ type: 'enum',
+ options: [
+ { label: 'FixedWidth', value: 0 },
+ { label: 'FixedHeight', value: 1 },
+ { label: 'Expand', value: 2 },
+ { label: 'Shrink', value: 3 },
+ { label: 'Match', value: 4 },
+ ],
+ },
+ { name: 'matchWidthOrHeight', type: 'number', min: 0, max: 1, step: 0.1 },
+ { name: 'backgroundColor', type: 'color' },
+ ],
+};
+
+const CameraSchema: ComponentSchema = {
+ name: 'Camera',
+ category: 'builtin',
+ properties: [
+ { name: 'isActive', type: 'boolean' },
+ {
+ name: 'projectionType',
+ type: 'enum',
+ options: [
+ { label: 'Perspective', value: 0 },
+ { label: 'Orthographic', value: 1 },
+ ],
+ },
+ { name: 'fov', type: 'number', min: 1, max: 179 },
+ { name: 'orthoSize', type: 'number', min: 0.1 },
+ { name: 'nearPlane', type: 'number', step: 0.1 },
+ { name: 'farPlane', type: 'number', step: 1 },
+ { name: 'priority', type: 'number', step: 1 },
+ { name: 'viewportX', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'viewportY', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'viewportW', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'viewportH', type: 'number', min: 0, max: 1, step: 0.01 },
+ {
+ name: 'clearFlags',
+ type: 'enum',
+ options: [
+ { label: 'None', value: 0 },
+ { label: 'Color Only', value: 1 },
+ { label: 'Depth Only', value: 2 },
+ { label: 'Color + Depth', value: 3 },
+ ],
+ },
+ { name: 'showFrustum', type: 'boolean' },
+ ],
+};
+
+const CORE_SCHEMAS: ComponentSchema[] = [
+ NameSchema, ParentSchema, ChildrenSchema, TransformSchema,
+ VelocitySchema, SceneOwnerSchema, CanvasSchema, CameraSchema,
+];
+
+export const coreComponentsPlugin: EditorPlugin = {
+ name: 'core-components',
+ register() {
+ for (const schema of CORE_SCHEMAS) {
+ registerComponentSchema(schema);
+ }
+ },
+};
+
+export { TransformSchema, CameraSchema };
diff --git a/editor/src/plugins/coreGizmos.ts b/editor/src/plugins/coreGizmos.ts
new file mode 100644
index 000000000..123fcad28
--- /dev/null
+++ b/editor/src/plugins/coreGizmos.ts
@@ -0,0 +1,9 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerBuiltinGizmos } from '../gizmos/builtinGizmos';
+
+export const coreGizmosPlugin: EditorPlugin = {
+ name: 'core-gizmos',
+ register() {
+ registerBuiltinGizmos();
+ },
+};
diff --git a/editor/src/plugins/coreMenus.ts b/editor/src/plugins/coreMenus.ts
new file mode 100644
index 000000000..5349765e8
--- /dev/null
+++ b/editor/src/plugins/coreMenus.ts
@@ -0,0 +1,18 @@
+import type { EditorPlugin, EditorPluginContext } from './EditorPlugin';
+import { registerBuiltinMenus } from '../menus/builtinMenus';
+import { registerBuiltinStatusbarItems } from '../menus/builtinStatusbar';
+
+export const coreMenusPlugin: EditorPlugin = {
+ name: 'core-menus',
+ register(ctx: EditorPluginContext) {
+ registerBuiltinMenus(ctx.editor);
+ },
+};
+
+export const coreStatusbarPlugin: EditorPlugin = {
+ name: 'core-statusbar',
+ dependencies: ['core-menus', 'core-panels'],
+ register(ctx: EditorPluginContext) {
+ registerBuiltinStatusbarItems(ctx.editor);
+ },
+};
diff --git a/editor/src/plugins/corePanels.ts b/editor/src/plugins/corePanels.ts
new file mode 100644
index 000000000..11f80799e
--- /dev/null
+++ b/editor/src/plugins/corePanels.ts
@@ -0,0 +1,12 @@
+import type { EditorPlugin, EditorPluginContext } from './EditorPlugin';
+import { registerBuiltinPanels } from '../panels/builtinPanels';
+
+export const corePanelsPlugin: EditorPlugin = {
+ name: 'core-panels',
+ register(ctx: EditorPluginContext) {
+ registerBuiltinPanels({
+ projectPath: ctx.projectPath ?? undefined,
+ onOpenScene: ctx.onOpenScene,
+ });
+ },
+};
diff --git a/editor/src/plugins/corePropertyEditors.ts b/editor/src/plugins/corePropertyEditors.ts
new file mode 100644
index 000000000..1d0919c0a
--- /dev/null
+++ b/editor/src/plugins/corePropertyEditors.ts
@@ -0,0 +1,9 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerBuiltinEditors } from '../property/editors';
+
+export const corePropertyEditorsPlugin: EditorPlugin = {
+ name: 'core-property-editors',
+ register() {
+ registerBuiltinEditors();
+ },
+};
diff --git a/editor/src/plugins/coreSettings.ts b/editor/src/plugins/coreSettings.ts
new file mode 100644
index 000000000..a4272a6da
--- /dev/null
+++ b/editor/src/plugins/coreSettings.ts
@@ -0,0 +1,64 @@
+import type { EditorPlugin } from './EditorPlugin';
+import {
+ registerSettingsSection,
+ registerSettingsGroup,
+ registerSettingsItem,
+ type SettingsItemType,
+} from '../settings/SettingsRegistry';
+import { DEFAULT_DESIGN_WIDTH, DEFAULT_DESIGN_HEIGHT } from 'esengine';
+import { renderCollisionMatrix } from '../settings/CollisionMatrixWidget';
+import { MAX_COLLISION_LAYERS } from '../settings/collisionLayers';
+
+export const coreSettingsPlugin: EditorPlugin = {
+ name: 'core-settings',
+ register() {
+ registerSettingsSection({ id: 'general', title: 'General', icon: 'settings', order: 0 });
+ registerSettingsSection({ id: 'project', title: 'Project', icon: 'folder', order: 2 });
+ registerSettingsSection({ id: 'rendering', title: 'Rendering', icon: 'image', order: 2.5 });
+ registerSettingsSection({ id: 'physics', title: 'Physics', icon: 'zap', order: 3 });
+ registerSettingsSection({ id: 'build', title: 'Build', icon: 'package', order: 4 });
+ registerSettingsSection({ id: 'asset-loading', title: 'Asset Loading', icon: 'download', order: 6.5 });
+ registerSettingsSection({ id: 'network', title: 'Network', icon: 'globe', order: 7 });
+
+ registerSettingsGroup({ id: 'physics.collision-layers', section: 'physics', label: 'Collision Layers', order: 10, collapsed: true });
+ registerSettingsGroup({ id: 'physics.collision-matrix', section: 'physics', label: 'Collision Matrix', order: 11 });
+
+ registerSettingsItem({ id: 'general.language', section: 'general', label: 'Language', type: 'select', defaultValue: 'en', order: 0, options: [{ label: 'English', value: 'en' }] });
+ registerSettingsItem({ id: 'general.previewPort', section: 'general', label: 'Preview Port', type: 'number', defaultValue: 3456, min: 1024, max: 65535, step: 1, order: 1 });
+
+ registerSettingsItem({ id: 'project.spineVersion', section: 'project', label: 'Spine Version', type: 'select', defaultValue: 'none', order: 0, projectSync: true, options: [{ label: 'None', value: 'none' }, { label: 'Spine 4.2', value: '4.2' }, { label: 'Spine 4.1', value: '4.1' }, { label: 'Spine 3.8', value: '3.8' }] });
+ registerSettingsItem({ id: 'project.name', section: 'project', label: 'Project Name', type: 'string', defaultValue: '', order: 1, projectSync: true });
+ registerSettingsItem({ id: 'project.version', section: 'project', label: 'Version', type: 'string', defaultValue: '', order: 2, projectSync: true });
+ registerSettingsItem({ id: 'project.defaultScene', section: 'project', label: 'Default Scene', type: 'string', defaultValue: '', order: 3, projectSync: true });
+ registerSettingsItem({ id: 'project.designWidth', section: 'project', label: 'Design Width', type: 'number', defaultValue: DEFAULT_DESIGN_WIDTH, min: 1, step: 1, order: 4, projectSync: true });
+ registerSettingsItem({ id: 'project.designHeight', section: 'project', label: 'Design Height', type: 'number', defaultValue: DEFAULT_DESIGN_HEIGHT, min: 1, step: 1, order: 5, projectSync: true });
+ registerSettingsItem({ id: 'project.enablePhysics', section: 'physics', label: 'Enable Physics', type: 'boolean', defaultValue: false, order: 0, projectSync: true });
+
+ registerSettingsItem({ id: 'rendering.defaultSpriteWidth', section: 'rendering', label: 'Default Sprite Width', description: 'Default width for new sprites in pixels', type: 'number', defaultValue: 100, min: 1, max: 4096, step: 1, order: 0, projectSync: true });
+ registerSettingsItem({ id: 'rendering.defaultSpriteHeight', section: 'rendering', label: 'Default Sprite Height', description: 'Default height for new sprites in pixels', type: 'number', defaultValue: 100, min: 1, max: 4096, step: 1, order: 1, projectSync: true });
+ registerSettingsItem({ id: 'rendering.pixelsPerUnit', section: 'rendering', label: 'Pixels Per Unit', description: 'Number of pixels per world unit', type: 'number', defaultValue: 100, min: 1, max: 1000, step: 1, order: 2, projectSync: true });
+
+ const COLLISION_LAYER_DEFAULTS = ['Default', '', '', '', '', '', '', '', '', '', '', '', '', '', '', ''];
+ for (let i = 0; i < MAX_COLLISION_LAYERS; i++) {
+ registerSettingsItem({ id: `physics.layerName${i}`, section: 'physics', group: 'physics.collision-layers', label: `Layer ${i}`, type: 'string', defaultValue: COLLISION_LAYER_DEFAULTS[i], order: i, projectSync: true, tags: ['collision', 'layer'] });
+ registerSettingsItem({ id: `physics.layerMask${i}`, section: 'physics', label: `Layer ${i} Mask`, type: 'number', defaultValue: 0xFFFF, hidden: true, projectSync: true });
+ }
+
+ registerSettingsItem({ id: 'physics.collisionMatrix', section: 'physics', group: 'physics.collision-matrix', label: 'Collision Matrix', type: 'custom' as SettingsItemType, defaultValue: null, render: renderCollisionMatrix, tags: ['collision', 'matrix', 'layer'] });
+ registerSettingsItem({ id: 'physics.gravityX', section: 'physics', label: 'Gravity X', type: 'number', defaultValue: 0, step: 0.1, order: 1, projectSync: true });
+ registerSettingsItem({ id: 'physics.gravityY', section: 'physics', label: 'Gravity Y', type: 'number', defaultValue: -9.81, step: 0.1, order: 2, projectSync: true });
+ registerSettingsItem({ id: 'physics.fixedTimestep', section: 'physics', label: 'Fixed Timestep', description: 'Maximum simulation time step in seconds', type: 'number', defaultValue: 1 / 60, step: 0.001, min: 0.001, order: 3, projectSync: true });
+ registerSettingsItem({ id: 'physics.subStepCount', section: 'physics', label: 'Sub-Step Count', description: 'Maximum physics sub-steps per frame', type: 'number', defaultValue: 4, step: 1, min: 1, max: 16, order: 4, projectSync: true });
+ registerSettingsItem({ id: 'physics.contactHertz', section: 'physics', label: 'Contact Hertz', description: 'Contact stiffness (cycles/sec). Higher = less overlap but more jitter', type: 'number', defaultValue: 30, step: 10, min: 1, max: 500, order: 5, projectSync: true });
+ registerSettingsItem({ id: 'physics.contactDampingRatio', section: 'physics', label: 'Contact Damping Ratio', description: 'Contact bounciness damping. Lower = faster overlap recovery but more energetic', type: 'number', defaultValue: 10, step: 1, min: 0.1, max: 100, order: 6, projectSync: true });
+ registerSettingsItem({ id: 'physics.contactSpeed', section: 'physics', label: 'Contact Speed', description: 'Max overlap resolution speed (m/s)', type: 'number', defaultValue: 3, step: 1, min: 1, max: 100, order: 7, projectSync: true });
+
+ registerSettingsItem({ id: 'build.atlasMaxSize', section: 'build', label: 'Atlas Max Size', type: 'select', defaultValue: '2048', order: 0, projectSync: true, options: [{ label: '512', value: '512' }, { label: '1024', value: '1024' }, { label: '2048', value: '2048' }, { label: '4096', value: '4096' }] });
+ registerSettingsItem({ id: 'build.atlasPadding', section: 'build', label: 'Atlas Padding', type: 'number', defaultValue: 2, min: 0, max: 16, step: 1, order: 1, projectSync: true });
+
+ registerSettingsItem({ id: 'asset.timeout', section: 'asset-loading', label: 'Load Timeout', description: 'Maximum time to wait for an asset load in milliseconds', type: 'number', defaultValue: 30000, min: 1000, max: 120000, step: 1000, order: 0, projectSync: true });
+ registerSettingsItem({ id: 'asset.failureCooldown', section: 'asset-loading', label: 'Failure Cooldown', description: 'Time to wait before retrying a failed asset load in milliseconds', type: 'number', defaultValue: 5000, min: 0, max: 60000, step: 1000, order: 1, projectSync: true });
+
+ registerSettingsItem({ id: 'network.proxy', section: 'network', label: 'HTTP Proxy', description: 'Proxy for update downloads (e.g. http://127.0.0.1:7890)', type: 'string', defaultValue: '', order: 0 });
+ },
+};
diff --git a/editor/src/plugins/importers.ts b/editor/src/plugins/importers.ts
new file mode 100644
index 000000000..15d664ff6
--- /dev/null
+++ b/editor/src/plugins/importers.ts
@@ -0,0 +1,10 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { getImporterRegistry } from '../asset/ImporterRegistry';
+
+export const importersPlugin: EditorPlugin = {
+ name: 'importers',
+ dependencies: ['asset-infra'],
+ register() {
+ getImporterRegistry();
+ },
+};
diff --git a/editor/src/plugins/index.ts b/editor/src/plugins/index.ts
new file mode 100644
index 000000000..b6f11a9f4
--- /dev/null
+++ b/editor/src/plugins/index.ts
@@ -0,0 +1,79 @@
+export type { EditorPlugin, EditorPluginContext } from './EditorPlugin';
+
+import type { EditorPlugin } from './EditorPlugin';
+import { assetInfraPlugin } from './assetInfra';
+import { importersPlugin } from './importers';
+import { corePropertyEditorsPlugin } from './corePropertyEditors';
+import { materialEditorsPlugin } from './materialEditors';
+import { coreComponentsPlugin } from './coreComponents';
+import { spritePlugin } from './sprite';
+import { textPlugin } from './text';
+import { uiPlugin } from './ui';
+import { physicsPlugin } from './physics';
+import { spinePlugin } from './spine';
+import { audioPlugin } from './audio';
+import { animationPlugin } from './animation';
+import { particlePlugin } from './particle';
+import { postProcessPlugin } from './postProcess';
+import { tilemapPlugin } from './tilemap';
+import { timelinePlugin } from './timeline';
+import { shapeRendererPlugin } from './shapeRenderer';
+import { coreGizmosPlugin } from './coreGizmos';
+import { coreSettingsPlugin } from './coreSettings';
+import { sceneViewSettingsPlugin } from './sceneViewSettings';
+import { runtimeSettingsPlugin } from './runtimeSettings';
+import { corePanelsPlugin } from './corePanels';
+import { coreMenusPlugin, coreStatusbarPlugin } from './coreMenus';
+
+export {
+ assetInfraPlugin,
+ importersPlugin,
+ corePropertyEditorsPlugin,
+ materialEditorsPlugin,
+ coreComponentsPlugin,
+ spritePlugin,
+ textPlugin,
+ uiPlugin,
+ physicsPlugin,
+ spinePlugin,
+ audioPlugin,
+ animationPlugin,
+ particlePlugin,
+ postProcessPlugin,
+ tilemapPlugin,
+ timelinePlugin,
+ shapeRendererPlugin,
+ coreGizmosPlugin,
+ coreSettingsPlugin,
+ sceneViewSettingsPlugin,
+ runtimeSettingsPlugin,
+ corePanelsPlugin,
+ coreMenusPlugin,
+ coreStatusbarPlugin,
+};
+
+export const builtinPlugins: EditorPlugin[] = [
+ assetInfraPlugin,
+ importersPlugin,
+ corePropertyEditorsPlugin,
+ materialEditorsPlugin,
+ coreComponentsPlugin,
+ spritePlugin,
+ textPlugin,
+ uiPlugin,
+ physicsPlugin,
+ spinePlugin,
+ audioPlugin,
+ animationPlugin,
+ particlePlugin,
+ postProcessPlugin,
+ tilemapPlugin,
+ timelinePlugin,
+ shapeRendererPlugin,
+ coreGizmosPlugin,
+ coreSettingsPlugin,
+ sceneViewSettingsPlugin,
+ runtimeSettingsPlugin,
+ corePanelsPlugin,
+ coreMenusPlugin,
+];
diff --git a/editor/src/plugins/materialEditors.ts b/editor/src/plugins/materialEditors.ts
new file mode 100644
index 000000000..d6d5883e3
--- /dev/null
+++ b/editor/src/plugins/materialEditors.ts
@@ -0,0 +1,10 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerMaterialEditors } from '../property/materialEditors';
+
+export const materialEditorsPlugin: EditorPlugin = {
+ name: 'material-editors',
+ dependencies: ['core-property-editors'],
+ register() {
+ registerMaterialEditors();
+ },
+};
diff --git a/editor/src/plugins/particle.ts b/editor/src/plugins/particle.ts
new file mode 100644
index 000000000..ec11746a6
--- /dev/null
+++ b/editor/src/plugins/particle.ts
@@ -0,0 +1,58 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+import { LAYER_MIN, LAYER_MAX } from '../schemas/schemaConstants';
+
+const ParticleEmitterSchema: ComponentSchema = {
+ name: 'ParticleEmitter',
+ category: 'builtin',
+ properties: [
+ { name: 'enabled', type: 'boolean' },
+ { name: 'playOnStart', type: 'boolean' },
+ { name: 'looping', type: 'boolean' },
+ { name: 'duration', type: 'number', min: 0, step: 0.1 },
+ { name: 'rate', type: 'number', min: 0, step: 1, group: 'Emission' },
+ { name: 'burstCount', type: 'number', min: 0, step: 1, group: 'Emission' },
+ { name: 'burstInterval', type: 'number', min: 0, step: 0.1, group: 'Emission' },
+ { name: 'maxParticles', type: 'number', min: 1, step: 1, group: 'Emission' },
+ { name: 'lifetimeMin', type: 'number', min: 0, step: 0.1, group: 'Lifetime' },
+ { name: 'lifetimeMax', type: 'number', min: 0, step: 0.1, group: 'Lifetime' },
+ { name: 'shape', type: 'enum', group: 'Shape', options: [{ label: 'Point', value: 0 }, { label: 'Circle', value: 1 }, { label: 'Rectangle', value: 2 }, { label: 'Cone', value: 3 }] },
+ { name: 'shapeRadius', type: 'number', min: 0, step: 0.1, group: 'Shape' },
+ { name: 'shapeSize', type: 'vec2', group: 'Shape' },
+ { name: 'shapeAngle', type: 'number', min: 0, max: 360, step: 1, group: 'Shape' },
+ { name: 'speedMin', type: 'number', min: 0, step: 0.1, group: 'Velocity' },
+ { name: 'speedMax', type: 'number', min: 0, step: 0.1, group: 'Velocity' },
+ { name: 'angleSpreadMin', type: 'number', min: 0, max: 360, step: 1, group: 'Velocity' },
+ { name: 'angleSpreadMax', type: 'number', min: 0, max: 360, step: 1, group: 'Velocity' },
+ { name: 'startSizeMin', type: 'number', min: 0, step: 0.1, group: 'Size' },
+ { name: 'startSizeMax', type: 'number', min: 0, step: 0.1, group: 'Size' },
+ { name: 'endSizeMin', type: 'number', min: 0, step: 0.1, group: 'Size' },
+ { name: 'endSizeMax', type: 'number', min: 0, step: 0.1, group: 'Size' },
+ { name: 'sizeEasing', type: 'enum', group: 'Size', options: [{ label: 'Linear', value: 0 }, { label: 'EaseIn', value: 1 }, { label: 'EaseOut', value: 2 }, { label: 'EaseInOut', value: 3 }] },
+ { name: 'startColor', type: 'color', group: 'Color' },
+ { name: 'endColor', type: 'color', group: 'Color' },
+ { name: 'colorEasing', type: 'enum', group: 'Color', options: [{ label: 'Linear', value: 0 }, { label: 'EaseIn', value: 1 }, { label: 'EaseOut', value: 2 }, { label: 'EaseInOut', value: 3 }] },
+ { name: 'rotationMin', type: 'number', step: 1, group: 'Rotation' },
+ { name: 'rotationMax', type: 'number', step: 1, group: 'Rotation' },
+ { name: 'angularVelocityMin', type: 'number', step: 1, group: 'Rotation' },
+ { name: 'angularVelocityMax', type: 'number', step: 1, group: 'Rotation' },
+ { name: 'gravity', type: 'vec2', group: 'Forces' },
+ { name: 'damping', type: 'number', min: 0, step: 0.01, group: 'Forces' },
+ { name: 'texture', type: 'texture', group: 'Texture' },
+ { name: 'spriteColumns', type: 'number', min: 1, step: 1, group: 'Texture' },
+ { name: 'spriteRows', type: 'number', min: 1, step: 1, group: 'Texture' },
+ { name: 'spriteFPS', type: 'number', min: 1, step: 1, group: 'Texture' },
+ { name: 'spriteLoop', type: 'boolean', group: 'Texture' },
+ { name: 'blendMode', type: 'enum', group: 'Rendering', options: [{ label: 'Normal', value: 0 }, { label: 'Additive', value: 1 }] },
+ { name: 'layer', type: 'number', min: LAYER_MIN, max: LAYER_MAX, group: 'Rendering' },
+ { name: 'material', type: 'material-file', group: 'Rendering' },
+ { name: 'simulationSpace', type: 'enum', group: 'Rendering', options: [{ label: 'World', value: 0 }, { label: 'Local', value: 1 }] },
+ ],
+};
+
+export const particlePlugin: EditorPlugin = {
+ name: 'particle',
+ register() {
+ registerComponentSchema(ParticleEmitterSchema);
+ },
+};
diff --git a/editor/src/plugins/physics.ts b/editor/src/plugins/physics.ts
new file mode 100644
index 000000000..438b81bca
--- /dev/null
+++ b/editor/src/plugins/physics.ts
@@ -0,0 +1,133 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+
+const RigidBodySchema: ComponentSchema = {
+ name: 'RigidBody',
+ category: 'physics',
+ properties: [
+ { name: 'bodyType', type: 'enum', options: [{ label: 'Static', value: 0 }, { label: 'Kinematic', value: 1 }, { label: 'Dynamic', value: 2 }] },
+ { name: 'gravityScale', type: 'number', step: 0.1 },
+ { name: 'linearDamping', type: 'number', min: 0, step: 0.1 },
+ { name: 'angularDamping', type: 'number', min: 0, step: 0.1 },
+ { name: 'fixedRotation', type: 'boolean' },
+ { name: 'bullet', type: 'boolean' },
+ { name: 'enabled', type: 'boolean' },
+ ],
+};
+
+const BoxColliderSchema: ComponentSchema = {
+ name: 'BoxCollider',
+ category: 'physics',
+ properties: [
+ { name: 'halfExtents', type: 'vec2' },
+ { name: 'offset', type: 'vec2' },
+ { name: 'radius', type: 'number', min: 0, step: 0.01 },
+ { name: 'density', type: 'number', min: 0, step: 0.1 },
+ { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'isSensor', type: 'boolean' },
+ { name: 'categoryBits', type: 'collision-layer' },
+ ],
+};
+
+const CircleColliderSchema: ComponentSchema = {
+ name: 'CircleCollider',
+ category: 'physics',
+ properties: [
+ { name: 'radius', type: 'number', min: 0, step: 0.01 },
+ { name: 'offset', type: 'vec2' },
+ { name: 'density', type: 'number', min: 0, step: 0.1 },
+ { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'isSensor', type: 'boolean' },
+ { name: 'categoryBits', type: 'collision-layer' },
+ ],
+};
+
+const CapsuleColliderSchema: ComponentSchema = {
+ name: 'CapsuleCollider',
+ category: 'physics',
+ properties: [
+ { name: 'radius', type: 'number', min: 0, step: 0.01 },
+ { name: 'halfHeight', type: 'number', min: 0, step: 0.01 },
+ { name: 'offset', type: 'vec2' },
+ { name: 'density', type: 'number', min: 0, step: 0.1 },
+ { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'isSensor', type: 'boolean' },
+ { name: 'categoryBits', type: 'collision-layer' },
+ ],
+};
+
+const SegmentColliderSchema: ComponentSchema = {
+ name: 'SegmentCollider',
+ category: 'physics',
+ properties: [
+ { name: 'point1', type: 'vec2' },
+ { name: 'point2', type: 'vec2' },
+ { name: 'density', type: 'number', min: 0, step: 0.1 },
+ { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'isSensor', type: 'boolean' },
+ { name: 'categoryBits', type: 'collision-layer' },
+ ],
+};
+
+const PolygonColliderSchema: ComponentSchema = {
+ name: 'PolygonCollider',
+ category: 'physics',
+ properties: [
+ { name: 'vertices', type: 'vec2-array', max: 8 },
+ { name: 'radius', type: 'number', min: 0, step: 0.01 },
+ { name: 'density', type: 'number', min: 0, step: 0.1 },
+ { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'isSensor', type: 'boolean' },
+ { name: 'categoryBits', type: 'collision-layer' },
+ ],
+};
+
+const ChainColliderSchema: ComponentSchema = {
+ name: 'ChainCollider',
+ category: 'physics',
+ properties: [
+ { name: 'points', type: 'vec2-array' },
+ { name: 'isLoop', type: 'boolean' },
+ { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'categoryBits', type: 'collision-layer' },
+ ],
+};
+
+const RevoluteJointSchema: ComponentSchema = {
+ name: 'RevoluteJoint',
+ category: 'physics',
+ properties: [
+ { name: 'connectedEntity', type: 'entity' },
+ { name: 'anchorA', type: 'vec2' },
+ { name: 'anchorB', type: 'vec2' },
+ { name: 'enableMotor', type: 'boolean' },
+ { name: 'motorSpeed', type: 'number', step: 0.1 },
+ { name: 'maxMotorTorque', type: 'number', min: 0, step: 1 },
+ { name: 'enableLimit', type: 'boolean' },
+ { name: 'lowerAngle', type: 'number', step: 0.01 },
+ { name: 'upperAngle', type: 'number', step: 0.01 },
+ { name: 'collideConnected', type: 'boolean' },
+ { name: 'enabled', type: 'boolean' },
+ ],
+};
+
+const PHYSICS_SCHEMAS: ComponentSchema[] = [
+ RigidBodySchema, BoxColliderSchema, CircleColliderSchema,
+ CapsuleColliderSchema, SegmentColliderSchema, PolygonColliderSchema,
+ ChainColliderSchema, RevoluteJointSchema,
+];
+
+export const physicsPlugin: EditorPlugin = {
+ name: 'physics',
+ register() {
+ for (const schema of PHYSICS_SCHEMAS) {
+ registerComponentSchema(schema);
+ }
+ },
+};
diff --git a/editor/src/plugins/postProcess.ts b/editor/src/plugins/postProcess.ts
new file mode 100644
index 000000000..0e1d85f9e
--- /dev/null
+++ b/editor/src/plugins/postProcess.ts
@@ -0,0 +1,17 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+import { registerPostProcessVolumeInspector } from '../panels/inspector/PostProcessVolumeInspector';
+
+const PostProcessVolumeSchema: ComponentSchema = {
+ name: 'PostProcessVolume',
+ category: 'builtin',
+ properties: [],
+};
+
+export const postProcessPlugin: EditorPlugin = {
+ name: 'post-process',
+ register() {
+ registerComponentSchema(PostProcessVolumeSchema);
+ registerPostProcessVolumeInspector();
+ },
+};
diff --git a/editor/src/plugins/runtimeSettings.ts b/editor/src/plugins/runtimeSettings.ts
new file mode 100644
index 000000000..e6ef1b103
--- /dev/null
+++ b/editor/src/plugins/runtimeSettings.ts
@@ -0,0 +1,30 @@
+import type { EditorPlugin } from './EditorPlugin';
+import {
+ registerSettingsSection,
+ registerSettingsGroup,
+ registerSettingsItem,
+} from '../settings/SettingsRegistry';
+
+export const runtimeSettingsPlugin: EditorPlugin = {
+ name: 'runtime-settings',
+ dependencies: ['core-settings'],
+ register() {
+ registerSettingsSection({ id: 'runtime', title: 'Runtime', icon: 'play', order: 5 });
+
+ registerSettingsGroup({ id: 'runtime.canvas', section: 'runtime', label: 'Canvas', order: 0 });
+ registerSettingsGroup({ id: 'runtime.timing', section: 'runtime', label: 'Timing', order: 1 });
+ registerSettingsGroup({ id: 'runtime.scene-transitions', section: 'runtime', label: 'Scene Transitions', order: 2 });
+
+ registerSettingsItem({ id: 'runtime.sceneTransitionDuration', section: 'runtime', group: 'runtime.scene-transitions', label: 'Scene Transition Duration', description: 'Fade duration when switching scenes, in seconds', type: 'number', defaultValue: 0.3, min: 0, max: 5, step: 0.1, order: 0, projectSync: true });
+ registerSettingsItem({ id: 'runtime.sceneTransitionColor', section: 'runtime', group: 'runtime.scene-transitions', label: 'Scene Transition Color', description: 'Background color during scene transitions', type: 'color', defaultValue: '#000000', order: 1, projectSync: true });
+
+ registerSettingsItem({ id: 'runtime.defaultFontFamily', section: 'runtime', label: 'Default Font Family', description: 'Fallback font used for text rendering', type: 'string', defaultValue: 'Arial', order: 2, projectSync: true });
+ registerSettingsItem({ id: 'runtime.textCanvasSize', section: 'runtime', label: 'Text Canvas Size', type: 'select', defaultValue: '512', order: 3, projectSync: true, options: [{ label: '256', value: '256' }, { label: '512', value: '512' }, { label: '1024', value: '1024' }, { label: '2048', value: '2048' }] });
+
+ registerSettingsItem({ id: 'runtime.canvasScaleMode', section: 'runtime', group: 'runtime.canvas', label: 'Canvas Scale Mode', description: 'How the canvas adapts to different screen sizes', type: 'select', defaultValue: 'FixedHeight', order: 0, projectSync: true, options: [{ label: 'Fixed Width', value: 'FixedWidth' }, { label: 'Fixed Height', value: 'FixedHeight' }, { label: 'Expand', value: 'Expand' }, { label: 'Shrink', value: 'Shrink' }, { label: 'Match', value: 'Match' }] });
+ registerSettingsItem({ id: 'runtime.canvasMatchWidthOrHeight', section: 'runtime', group: 'runtime.canvas', label: 'Canvas Match W/H', description: 'Blend between matching width (0) and height (1)', type: 'range', defaultValue: 0.5, min: 0, max: 1, step: 0.1, order: 1, projectSync: true, visibleWhen: { settingId: 'runtime.canvasScaleMode', value: 'Match' } });
+
+ registerSettingsItem({ id: 'runtime.maxDeltaTime', section: 'runtime', group: 'runtime.timing', label: 'Max Delta Time', description: 'Maximum allowed frame delta time in seconds', type: 'number', defaultValue: 0.25, min: 0.01, max: 1, step: 0.01, order: 0, projectSync: true });
+ registerSettingsItem({ id: 'runtime.maxFixedSteps', section: 'runtime', group: 'runtime.timing', label: 'Max Fixed Steps', description: 'Maximum fixed update iterations per frame', type: 'number', defaultValue: 8, min: 1, max: 64, step: 1, order: 1, projectSync: true });
+ },
+};
diff --git a/editor/src/plugins/sceneViewSettings.ts b/editor/src/plugins/sceneViewSettings.ts
new file mode 100644
index 000000000..aeeeaa62e
--- /dev/null
+++ b/editor/src/plugins/sceneViewSettings.ts
@@ -0,0 +1,36 @@
+import type { EditorPlugin } from './EditorPlugin';
+import {
+ registerSettingsSection,
+ registerSettingsGroup,
+ registerSettingsItem,
+} from '../settings/SettingsRegistry';
+
+export const sceneViewSettingsPlugin: EditorPlugin = {
+ name: 'scene-view-settings',
+ dependencies: ['core-settings'],
+ register() {
+ registerSettingsSection({ id: 'scene-view', title: 'Scene View', icon: 'eye', order: 1 });
+
+ registerSettingsGroup({ id: 'scene-view.grid', section: 'scene-view', label: 'Grid', order: 0 });
+ registerSettingsGroup({ id: 'scene-view.overlays', section: 'scene-view', label: 'Overlays', order: 1 });
+ registerSettingsGroup({ id: 'scene-view.gizmo-appearance', section: 'scene-view', label: 'Gizmo Appearance', order: 2, collapsed: true });
+
+ registerSettingsItem({ id: 'scene.showGrid', section: 'scene-view', group: 'scene-view.grid', label: 'Show Grid', type: 'boolean', defaultValue: true, order: 0 });
+ registerSettingsItem({ id: 'scene.gridColor', section: 'scene-view', group: 'scene-view.grid', label: 'Grid Color', type: 'color', defaultValue: '#333333', order: 1 });
+ registerSettingsItem({ id: 'scene.gridOpacity', section: 'scene-view', group: 'scene-view.grid', label: 'Grid Opacity', type: 'range', defaultValue: 1.0, min: 0, max: 1, step: 0.1, order: 2 });
+ registerSettingsItem({ id: 'scene.gridSize', section: 'scene-view', group: 'scene-view.grid', label: 'Grid Size', type: 'number', defaultValue: 50, min: 5, max: 500, step: 5, order: 3 });
+
+ registerSettingsItem({ id: 'scene.showGizmos', section: 'scene-view', group: 'scene-view.overlays', label: 'Show Gizmos', type: 'boolean', defaultValue: true, order: 0 });
+ registerSettingsItem({ id: 'scene.showSelectionBox', section: 'scene-view', group: 'scene-view.overlays', label: 'Show Selection Box', type: 'boolean', defaultValue: true, order: 1 });
+ registerSettingsItem({ id: 'scene.showColliders', section: 'scene-view', group: 'scene-view.overlays', label: 'Show Colliders', type: 'boolean', defaultValue: true, order: 2 });
+ registerSettingsItem({ id: 'scene.showStats', section: 'scene-view', group: 'scene-view.overlays', label: 'Show Stats', type: 'boolean', defaultValue: false, order: 3 });
+
+ registerSettingsItem({ id: 'scene.gizmoColorX', section: 'scene-view', group: 'scene-view.gizmo-appearance', label: 'Gizmo Color X', type: 'color', defaultValue: '#e74c3c', order: 0, tags: ['gizmo', 'color'] });
+ registerSettingsItem({ id: 'scene.gizmoColorY', section: 'scene-view', group: 'scene-view.gizmo-appearance', label: 'Gizmo Color Y', type: 'color', defaultValue: '#2ecc71', order: 1, tags: ['gizmo', 'color'] });
+ registerSettingsItem({ id: 'scene.gizmoColorXY', section: 'scene-view', group: 'scene-view.gizmo-appearance', label: 'Gizmo Color XY', type: 'color', defaultValue: '#f1c40f', order: 2, tags: ['gizmo', 'color'] });
+ registerSettingsItem({ id: 'scene.gizmoColorHover', section: 'scene-view', group: 'scene-view.gizmo-appearance', label: 'Gizmo Color Hover', type: 'color', defaultValue: '#ffffff', order: 3, tags: ['gizmo', 'color'] });
+ registerSettingsItem({ id: 'scene.selectionColor', section: 'scene-view', group: 'scene-view.gizmo-appearance', label: 'Selection Color', type: 'color', defaultValue: '#00aaff', order: 4, tags: ['gizmo', 'selection'] });
+ registerSettingsItem({ id: 'scene.gizmoHandleSize', section: 'scene-view', group: 'scene-view.gizmo-appearance', label: 'Gizmo Handle Size', type: 'number', defaultValue: 10, min: 4, max: 24, step: 1, order: 5, tags: ['gizmo'] });
+ registerSettingsItem({ id: 'scene.gizmoSize', section: 'scene-view', group: 'scene-view.gizmo-appearance', label: 'Gizmo Size', type: 'number', defaultValue: 80, min: 40, max: 200, step: 5, order: 6, tags: ['gizmo'] });
+ },
+};
diff --git a/editor/src/plugins/shapeRenderer.ts b/editor/src/plugins/shapeRenderer.ts
new file mode 100644
index 000000000..e846a5d61
--- /dev/null
+++ b/editor/src/plugins/shapeRenderer.ts
@@ -0,0 +1,30 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+import { LAYER_MIN, LAYER_MAX } from '../schemas/schemaConstants';
+
+const ShapeRendererSchema: ComponentSchema = {
+ name: 'ShapeRenderer',
+ category: 'builtin',
+ properties: [
+ {
+ name: 'shapeType',
+ type: 'enum',
+ options: [
+ { label: 'Circle', value: 0 },
+ { label: 'Capsule', value: 1 },
+ { label: 'RoundedRect', value: 2 },
+ ],
+ },
+ { name: 'color', type: 'color' },
+ { name: 'size', type: 'vec2' },
+ { name: 'cornerRadius', type: 'number', min: 0 },
+ { name: 'layer', type: 'number', min: LAYER_MIN, max: LAYER_MAX },
+ ],
+};
+
+export const shapeRendererPlugin: EditorPlugin = {
+ name: 'shape-renderer',
+ register() {
+ registerComponentSchema(ShapeRendererSchema);
+ },
+};
diff --git a/editor/src/plugins/spine.ts b/editor/src/plugins/spine.ts
new file mode 100644
index 000000000..ee513b046
--- /dev/null
+++ b/editor/src/plugins/spine.ts
@@ -0,0 +1,37 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+import { registerBoundsProvider } from '../bounds/BoundsRegistry';
+import { spineAnimationBoundsProvider } from '../bounds/SpineAnimationBoundsProvider';
+import {
+ LAYER_MIN, LAYER_MAX,
+ TIME_SCALE_MAX,
+ SKELETON_SCALE_MIN, SKELETON_SCALE_MAX,
+} from '../schemas/schemaConstants';
+
+const SpineAnimationSchema: ComponentSchema = {
+ name: 'SpineAnimation',
+ category: 'builtin',
+ properties: [
+ { name: 'skeletonPath', type: 'spine-file', fileFilter: ['.json', '.skel'] },
+ { name: 'atlasPath', type: 'spine-file', fileFilter: ['.atlas'] },
+ { name: 'material', type: 'material-file' },
+ { name: 'skin', type: 'spine-skin', dependsOn: 'skeletonPath' },
+ { name: 'animation', type: 'spine-animation', dependsOn: 'skeletonPath' },
+ { name: 'timeScale', type: 'number', min: 0, max: TIME_SCALE_MAX, step: 0.1 },
+ { name: 'loop', type: 'boolean' },
+ { name: 'playing', type: 'boolean' },
+ { name: 'flipX', type: 'boolean' },
+ { name: 'flipY', type: 'boolean' },
+ { name: 'color', type: 'color' },
+ { name: 'layer', type: 'number', min: LAYER_MIN, max: LAYER_MAX },
+ { name: 'skeletonScale', type: 'number', min: SKELETON_SCALE_MIN, max: SKELETON_SCALE_MAX, step: 0.01 },
+ ],
+};
+
+export const spinePlugin: EditorPlugin = {
+ name: 'spine',
+ register() {
+ registerComponentSchema(SpineAnimationSchema);
+ registerBoundsProvider('SpineAnimation', spineAnimationBoundsProvider);
+ },
+};
diff --git a/editor/src/plugins/sprite.ts b/editor/src/plugins/sprite.ts
new file mode 100644
index 000000000..d333b9cce
--- /dev/null
+++ b/editor/src/plugins/sprite.ts
@@ -0,0 +1,32 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+import { registerBoundsProvider } from '../bounds/BoundsRegistry';
+import { spriteBoundsProvider } from '../bounds/SpriteBoundsProvider';
+import { LAYER_MIN, LAYER_MAX } from '../schemas/schemaConstants';
+
+const SpriteSchema: ComponentSchema = {
+ name: 'Sprite',
+ category: 'builtin',
+ properties: [
+ { name: 'texture', type: 'texture' },
+ { name: 'material', type: 'material-file' },
+ { name: 'color', type: 'color' },
+ { name: 'size', type: 'vec2', hiddenWhen: { hasComponent: 'UIRect' } },
+ { name: 'uvOffset', type: 'vec2' },
+ { name: 'uvScale', type: 'vec2' },
+ { name: 'layer', type: 'number', min: LAYER_MIN, max: LAYER_MAX },
+ { name: 'flipX', type: 'boolean' },
+ { name: 'flipY', type: 'boolean' },
+ ],
+};
+
+export const spritePlugin: EditorPlugin = {
+ name: 'sprite',
+ dependencies: ['core-components'],
+ register() {
+ registerComponentSchema(SpriteSchema);
+ registerBoundsProvider('Sprite', spriteBoundsProvider);
+ },
+};
+
+export { SpriteSchema };
diff --git a/editor/src/plugins/text.ts b/editor/src/plugins/text.ts
new file mode 100644
index 000000000..11569e077
--- /dev/null
+++ b/editor/src/plugins/text.ts
@@ -0,0 +1,79 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+import { registerBoundsProvider } from '../bounds/BoundsRegistry';
+import { textBoundsProvider } from '../bounds/TextBoundsProvider';
+import { LAYER_MIN, LAYER_MAX, FONT_SIZE_MIN, FONT_SIZE_MAX } from '../schemas/schemaConstants';
+
+const TextSchema: ComponentSchema = {
+ name: 'Text',
+ category: 'ui',
+ properties: [
+ { name: 'content', type: 'string' },
+ { name: 'fontFamily', type: 'font' },
+ { name: 'fontSize', type: 'number', min: FONT_SIZE_MIN, max: FONT_SIZE_MAX },
+ { name: 'color', type: 'color' },
+ {
+ name: 'align',
+ type: 'enum',
+ options: [
+ { label: 'Left', value: 0 },
+ { label: 'Center', value: 1 },
+ { label: 'Right', value: 2 },
+ ],
+ },
+ {
+ name: 'verticalAlign',
+ type: 'enum',
+ options: [
+ { label: 'Top', value: 0 },
+ { label: 'Middle', value: 1 },
+ { label: 'Bottom', value: 2 },
+ ],
+ },
+ { name: 'wordWrap', type: 'boolean' },
+ {
+ name: 'overflow',
+ type: 'enum',
+ options: [
+ { label: 'Visible', value: 0 },
+ { label: 'Clip', value: 1 },
+ { label: 'Ellipsis', value: 2 },
+ ],
+ },
+ { name: 'lineHeight', type: 'number', min: 0.5, max: 3, step: 0.1 },
+ ],
+};
+
+const BitmapTextSchema: ComponentSchema = {
+ name: 'BitmapText',
+ category: 'ui',
+ properties: [
+ { name: 'text', type: 'string' },
+ { name: 'font', type: 'bitmap-font-file' },
+ { name: 'color', type: 'color' },
+ { name: 'fontSize', type: 'number', min: 0.1, step: 0.1 },
+ {
+ name: 'align',
+ type: 'enum',
+ options: [
+ { label: 'Left', value: 0 },
+ { label: 'Center', value: 1 },
+ { label: 'Right', value: 2 },
+ ],
+ },
+ { name: 'spacing', type: 'number', step: 0.1 },
+ { name: 'layer', type: 'number', min: LAYER_MIN, max: LAYER_MAX },
+ ],
+};
+
+export const textPlugin: EditorPlugin = {
+ name: 'text',
+ dependencies: ['core-components'],
+ register() {
+ registerComponentSchema(TextSchema);
+ registerComponentSchema(BitmapTextSchema);
+ registerBoundsProvider('Text', textBoundsProvider);
+ },
+};
+
+export { TextSchema };
diff --git a/editor/src/plugins/tilemap.ts b/editor/src/plugins/tilemap.ts
new file mode 100644
index 000000000..bb7b8a1b7
--- /dev/null
+++ b/editor/src/plugins/tilemap.ts
@@ -0,0 +1,34 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+import { LAYER_MIN, LAYER_MAX } from '../schemas/schemaConstants';
+
+const TilemapSchema: ComponentSchema = {
+ name: 'Tilemap',
+ category: 'builtin',
+ properties: [
+ { name: 'source', type: 'tilemap-file' },
+ ],
+};
+
+const TilemapLayerSchema: ComponentSchema = {
+ name: 'TilemapLayer',
+ category: 'builtin',
+ hidden: true,
+ properties: [
+ { name: 'width', type: 'number', min: 1, max: 1000 },
+ { name: 'height', type: 'number', min: 1, max: 1000 },
+ { name: 'tileWidth', type: 'number', min: 1, max: 512 },
+ { name: 'tileHeight', type: 'number', min: 1, max: 512 },
+ { name: 'texture', type: 'number' },
+ { name: 'tilesetColumns', type: 'number', min: 1, max: 256 },
+ { name: 'layer', type: 'number', min: LAYER_MIN, max: LAYER_MAX },
+ ],
+};
+
+export const tilemapPlugin: EditorPlugin = {
+ name: 'tilemap',
+ register() {
+ registerComponentSchema(TilemapSchema);
+ registerComponentSchema(TilemapLayerSchema);
+ },
+};
diff --git a/editor/src/plugins/timeline.ts b/editor/src/plugins/timeline.ts
new file mode 100644
index 000000000..38bc03eec
--- /dev/null
+++ b/editor/src/plugins/timeline.ts
@@ -0,0 +1,21 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+import { TIME_SCALE_MAX } from '../schemas/schemaConstants';
+
+const TimelinePlayerSchema: ComponentSchema = {
+ name: 'TimelinePlayer',
+ category: 'builtin',
+ properties: [
+ { name: 'timeline', type: 'timeline-file' },
+ { name: 'playing', type: 'boolean' },
+ { name: 'speed', type: 'number', min: 0, max: TIME_SCALE_MAX, step: 0.1 },
+ { name: 'wrapMode', type: 'enum', options: [{ label: 'Once', value: 'once' }, { label: 'Loop', value: 'loop' }, { label: 'Ping Pong', value: 'pingPong' }] },
+ ],
+};
+
+export const timelinePlugin: EditorPlugin = {
+ name: 'timeline',
+ register() {
+ registerComponentSchema(TimelinePlayerSchema);
+ },
+};
diff --git a/editor/src/plugins/ui.ts b/editor/src/plugins/ui.ts
new file mode 100644
index 000000000..d49975320
--- /dev/null
+++ b/editor/src/plugins/ui.ts
@@ -0,0 +1,243 @@
+import type { EditorPlugin } from './EditorPlugin';
+import { registerComponentSchema, type ComponentSchema } from '../schemas/ComponentSchemas';
+import { registerBoundsProvider } from '../bounds/BoundsRegistry';
+import { uiRectBoundsProvider } from '../bounds/UIRectBoundsProvider';
+
+const UIRectSchema: ComponentSchema = {
+ name: 'UIRect',
+ category: 'ui',
+ properties: [
+ { name: '*', type: 'uirect' },
+ ],
+};
+
+const UIMaskSchema: ComponentSchema = {
+ name: 'UIMask',
+ category: 'ui',
+ properties: [
+ { name: 'enabled', type: 'boolean' },
+ { name: 'mode', type: 'enum', options: [{ label: 'Scissor', value: 0 }, { label: 'Stencil', value: 1 }] },
+ ],
+};
+
+const InteractableSchema: ComponentSchema = {
+ name: 'Interactable',
+ category: 'ui',
+ properties: [
+ { name: 'enabled', type: 'boolean' },
+ { name: 'blockRaycast', type: 'boolean' },
+ { name: 'raycastTarget', type: 'boolean' },
+ ],
+};
+
+const UIInteractionSchema: ComponentSchema = {
+ name: 'UIInteraction',
+ category: 'tag',
+ removable: false,
+ properties: [],
+};
+
+const ButtonSchema: ComponentSchema = {
+ name: 'Button',
+ category: 'ui',
+ properties: [
+ { name: 'state', type: 'enum', options: [{ label: 'Normal', value: 0 }, { label: 'Hovered', value: 1 }, { label: 'Pressed', value: 2 }, { label: 'Disabled', value: 3 }] },
+ { name: 'transition', type: 'button-transition' },
+ ],
+};
+
+const TextInputSchema: ComponentSchema = {
+ name: 'TextInput',
+ category: 'ui',
+ properties: [
+ { name: 'value', type: 'string' },
+ { name: 'placeholder', type: 'string' },
+ { name: 'placeholderColor', type: 'color' },
+ { name: 'fontFamily', type: 'font' },
+ { name: 'fontSize', type: 'number', min: 8, max: 200 },
+ { name: 'color', type: 'color' },
+ { name: 'backgroundColor', type: 'color' },
+ { name: 'padding', type: 'number', min: 0, step: 1 },
+ { name: 'maxLength', type: 'number', min: 0, step: 1 },
+ { name: 'multiline', type: 'boolean' },
+ { name: 'password', type: 'boolean' },
+ { name: 'readOnly', type: 'boolean' },
+ ],
+};
+
+const ImageSchema: ComponentSchema = {
+ name: 'Image',
+ category: 'ui',
+ properties: [
+ { name: 'texture', type: 'texture' },
+ { name: 'material', type: 'material-file' },
+ { name: 'color', type: 'color' },
+ { name: 'imageType', type: 'enum', options: [{ label: 'Simple', value: 0 }, { label: 'Sliced', value: 1 }, { label: 'Tiled', value: 2 }, { label: 'Filled', value: 3 }] },
+ { name: 'fillMethod', type: 'enum', options: [{ label: 'Horizontal', value: 0 }, { label: 'Vertical', value: 1 }] },
+ { name: 'fillOrigin', type: 'enum', options: [{ label: 'Left', value: 0 }, { label: 'Right', value: 1 }, { label: 'Bottom', value: 2 }, { label: 'Top', value: 3 }] },
+ { name: 'fillAmount', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'preserveAspect', type: 'boolean' },
+ { name: 'tileSize', type: 'vec2' },
+ { name: 'layer', type: 'number', min: -1000, max: 1000 },
+ ],
+};
+
+const ToggleSchema: ComponentSchema = {
+ name: 'Toggle',
+ category: 'ui',
+ properties: [
+ { name: 'isOn', type: 'boolean' },
+ { name: 'graphicEntity', type: 'entity' },
+ { name: 'transition', type: 'button-transition' },
+ ],
+};
+
+const ToggleGroupSchema: ComponentSchema = {
+ name: 'ToggleGroup',
+ category: 'ui',
+ properties: [{ name: 'allowSwitchOff', type: 'boolean' }],
+};
+
+const ProgressBarSchema: ComponentSchema = {
+ name: 'ProgressBar',
+ category: 'ui',
+ properties: [
+ { name: 'value', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'fillEntity', type: 'entity' },
+ { name: 'direction', type: 'enum', options: [{ label: 'LeftToRight', value: 0 }, { label: 'RightToLeft', value: 1 }, { label: 'BottomToTop', value: 2 }, { label: 'TopToBottom', value: 3 }] },
+ ],
+};
+
+const DraggableSchema: ComponentSchema = {
+ name: 'Draggable',
+ category: 'ui',
+ properties: [
+ { name: 'enabled', type: 'boolean' },
+ { name: 'dragThreshold', type: 'number', min: 0, step: 1 },
+ { name: 'lockX', type: 'boolean' },
+ { name: 'lockY', type: 'boolean' },
+ ],
+};
+
+const ScrollViewSchema: ComponentSchema = {
+ name: 'ScrollView',
+ category: 'ui',
+ properties: [
+ { name: 'contentEntity', type: 'entity' },
+ { name: 'horizontalEnabled', type: 'boolean' },
+ { name: 'verticalEnabled', type: 'boolean' },
+ { name: 'contentWidth', type: 'number', min: 0, step: 1 },
+ { name: 'contentHeight', type: 'number', min: 0, step: 1 },
+ { name: 'inertia', type: 'boolean' },
+ { name: 'decelerationRate', type: 'number', min: 0, max: 1, step: 0.01 },
+ { name: 'elastic', type: 'boolean' },
+ { name: 'wheelSensitivity', type: 'number', min: 0, max: 1, step: 0.01 },
+ ],
+};
+
+const SliderSchema: ComponentSchema = {
+ name: 'Slider',
+ category: 'ui',
+ properties: [
+ { name: 'value', type: 'number', step: 0.01 },
+ { name: 'minValue', type: 'number', step: 0.01 },
+ { name: 'maxValue', type: 'number', step: 0.01 },
+ { name: 'direction', type: 'enum', options: [{ label: 'LeftToRight', value: 0 }, { label: 'RightToLeft', value: 1 }, { label: 'BottomToTop', value: 2 }, { label: 'TopToBottom', value: 3 }] },
+ { name: 'fillEntity', type: 'entity' },
+ { name: 'handleEntity', type: 'entity' },
+ { name: 'wholeNumbers', type: 'boolean' },
+ ],
+};
+
+const FocusableSchema: ComponentSchema = {
+ name: 'Focusable',
+ category: 'ui',
+ properties: [{ name: 'tabIndex', type: 'number', min: 0, step: 1 }],
+};
+
+const SafeAreaSchema: ComponentSchema = {
+ name: 'SafeArea',
+ category: 'ui',
+ properties: [
+ { name: 'applyTop', type: 'boolean' },
+ { name: 'applyBottom', type: 'boolean' },
+ { name: 'applyLeft', type: 'boolean' },
+ { name: 'applyRight', type: 'boolean' },
+ ],
+};
+
+const ListViewSchema: ComponentSchema = {
+ name: 'ListView',
+ category: 'ui',
+ properties: [
+ { name: 'itemHeight', type: 'number', min: 1, step: 1 },
+ { name: 'itemCount', type: 'number', min: 0, step: 1 },
+ { name: 'overscan', type: 'number', min: 0, step: 1 },
+ ],
+};
+
+const DropdownSchema: ComponentSchema = {
+ name: 'Dropdown',
+ category: 'ui',
+ properties: [
+ { name: 'options', type: 'string-array' },
+ { name: 'selectedIndex', type: 'number', min: -1, step: 1 },
+ { name: 'listEntity', type: 'entity' },
+ { name: 'labelEntity', type: 'entity' },
+ ],
+};
+
+const FlexContainerSchema: ComponentSchema = {
+ name: 'FlexContainer',
+ category: 'ui',
+ properties: [
+ { name: 'direction', type: 'enum', options: [{ label: 'Row', value: 0 }, { label: 'Column', value: 1 }, { label: 'RowReverse', value: 2 }, { label: 'ColumnReverse', value: 3 }] },
+ { name: 'wrap', type: 'enum', options: [{ label: 'NoWrap', value: 0 }, { label: 'Wrap', value: 1 }] },
+ { name: 'justifyContent', type: 'enum', options: [{ label: 'Start', value: 0 }, { label: 'Center', value: 1 }, { label: 'End', value: 2 }, { label: 'SpaceBetween', value: 3 }, { label: 'SpaceAround', value: 4 }, { label: 'SpaceEvenly', value: 5 }] },
+ { name: 'alignItems', type: 'enum', options: [{ label: 'Start', value: 0 }, { label: 'Center', value: 1 }, { label: 'End', value: 2 }, { label: 'Stretch', value: 3 }] },
+ { name: 'gap', type: 'vec2' },
+ { name: 'padding', type: 'vec4' },
+ ],
+};
+
+const FlexItemSchema: ComponentSchema = {
+ name: 'FlexItem',
+ category: 'ui',
+ properties: [
+ { name: 'flexGrow', type: 'number', min: 0, step: 0.1 },
+ { name: 'flexShrink', type: 'number', min: 0, step: 0.1 },
+ { name: 'flexBasis', type: 'number', step: 1 },
+ { name: 'order', type: 'number', step: 1 },
+ ],
+};
+
+const LayoutGroupSchema: ComponentSchema = {
+ name: 'LayoutGroup',
+ category: 'ui',
+ properties: [
+ { name: 'direction', type: 'enum', options: [{ label: 'Horizontal', value: 0 }, { label: 'Vertical', value: 1 }] },
+ { name: 'spacing', type: 'number', step: 1 },
+ { name: 'childAlignment', type: 'enum', options: [{ label: 'Start', value: 0 }, { label: 'Center', value: 1 }, { label: 'End', value: 2 }] },
+ { name: 'reverseOrder', type: 'boolean' },
+ ],
+};
+
+const UI_SCHEMAS: ComponentSchema[] = [
+ UIRectSchema, UIMaskSchema, InteractableSchema, UIInteractionSchema,
+ ButtonSchema, TextInputSchema, ImageSchema,
+ ToggleSchema, ToggleGroupSchema, ProgressBarSchema,
+ DraggableSchema, ScrollViewSchema, SliderSchema, FocusableSchema,
+ SafeAreaSchema, ListViewSchema, DropdownSchema,
+ FlexContainerSchema, FlexItemSchema, LayoutGroupSchema,
+];
+
+export const uiPlugin: EditorPlugin = {
+ name: 'ui',
+ dependencies: ['core-components'],
+ register() {
+ for (const schema of UI_SCHEMAS) {
+ registerComponentSchema(schema);
+ }
+ registerBoundsProvider('UIRect', uiRectBoundsProvider);
+ },
+};
diff --git a/editor/src/property/editors.ts b/editor/src/property/editors.ts
index 202dd3bf0..3f743f75a 100644
--- a/editor/src/property/editors.ts
+++ b/editor/src/property/editors.ts
@@ -20,6 +20,7 @@ import { setupDragLabel, colorToHex, hexToColor } from './editorUtils';
import { validateNumber, validateVec2, validateVec3, validateColor, showValidationError } from './validation';
import { getNamedLayers, layerIndexFromBits, bitsFromLayerIndex } from '../settings/collisionLayers';
import { onSettingsChange } from '../settings/SettingsRegistry';
+import { AssetType } from '../constants/AssetTypes';
export { setupDragLabel, colorToHex, hexToColor };
// =============================================================================
@@ -669,18 +670,18 @@ function createEnumEditor(
// Texture Editor
// =============================================================================
-function getNativeFS(): NativeFS | null {
+export function getNativeFS(): NativeFS | null {
return getEditorContext().fs ?? null;
}
-function getProjectDir(): string | null {
+export function getProjectDir(): string | null {
const editor = getEditorInstance();
const projectPath = editor?.projectPath;
if (!projectPath) return null;
return projectPath.replace(/\\/g, '/').replace(/\/[^/]+$/, '');
}
-function getMimeType(path: string): string {
+export function getMimeType(path: string): string {
const ext = path.split('.').pop()?.toLowerCase() ?? '';
return getAssetMimeType(ext) ?? 'image/png';
}
@@ -748,12 +749,12 @@ function createTextureEditor(
const browseBtn = document.createElement('button');
browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
+ browseBtn.innerHTML = BROWSE_ICON;
const clearBtn = document.createElement('button');
clearBtn.className = 'es-btn es-btn-icon es-btn-clear';
clearBtn.title = 'Clear';
- clearBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>`;
+ clearBtn.innerHTML = CLEAR_ICON;
const updatePreview = async (textureRef: string) => {
const gen = ++previewGeneration;
@@ -809,75 +810,20 @@ function createTextureEditor(
input.addEventListener('click', navigateToAssetPath);
preview.addEventListener('click', navigateToAssetPath);
- wrapper.addEventListener('dragover', (e) => {
- e.preventDefault();
- const data = e.dataTransfer?.types.includes('application/esengine-asset');
- if (data) {
- wrapper.classList.add('es-drag-over');
- e.dataTransfer!.dropEffect = 'copy';
- } else {
- e.dataTransfer!.dropEffect = 'none';
- }
- });
-
- wrapper.addEventListener('dragleave', () => {
- wrapper.classList.remove('es-drag-over');
- });
-
- wrapper.addEventListener('drop', (e) => {
- e.preventDefault();
- wrapper.classList.remove('es-drag-over');
-
- const jsonData = e.dataTransfer?.getData('application/esengine-asset');
- if (!jsonData) return;
-
- try {
- const assetData = JSON.parse(jsonData);
- if (assetData.type === 'image') {
- const projectDir = getProjectDir();
- if (projectDir && assetData.path.startsWith(projectDir)) {
- const relativePath = assetData.path.substring(projectDir.length + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- currentRef = ref;
- onChange(ref);
- updatePreview(ref);
- }
- }
- } catch (err) {
- console.error('Failed to parse drop data:', err);
- }
+ handleAssetDrop(wrapper, [AssetType.IMAGE], (relativePath, ref) => {
+ input.value = relativePath;
+ currentRef = ref;
+ onChange(ref);
+ updatePreview(ref);
});
browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
-
- const assetsDir = `${projectDir}/assets`;
-
- try {
- const platform = getPlatformAdapter();
- const result = await platform.openFileDialog({
- title: 'Select Texture',
- defaultPath: assetsDir,
- filters: [{ name: 'Images', extensions: ['png', 'jpg', 'jpeg', 'webp'] }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- currentRef = ref;
- onChange(ref);
- updatePreview(ref);
- }
- }
- } catch (err) {
- console.error('Failed to open file dialog:', err);
+ const result = await browseForAsset('Select Texture', 'Images', ['png', 'jpg', 'jpeg', 'webp']);
+ if (result) {
+ input.value = result.relativePath;
+ currentRef = result.ref;
+ onChange(result.ref);
+ updatePreview(result.ref);
}
});
@@ -1031,44 +977,23 @@ function createSpineFileEditor(
const browseBtn = document.createElement('button');
browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
+ browseBtn.innerHTML = BROWSE_ICON;
const clearBtn = document.createElement('button');
clearBtn.className = 'es-btn es-btn-icon es-btn-clear';
clearBtn.title = 'Clear';
- clearBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>`;
+ clearBtn.innerHTML = CLEAR_ICON;
input.addEventListener('change', () => {
onChange(input.value || '');
});
browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
-
- const assetsDir = `${projectDir}/assets`;
-
- try {
- const platform = getPlatformAdapter();
- const extensions = fileFilter.map(f => f.replace('.', ''));
- const result = await platform.openFileDialog({
- title: 'Select File',
- defaultPath: assetsDir,
- filters: [{ name: 'Spine Files', extensions }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
- }
- } catch (err) {
- console.error('Failed to open file dialog:', err);
+ const extensions = fileFilter.map((f: string) => f.replace('.', ''));
+ const result = await browseForAsset('Select File', 'Spine Files', extensions);
+ if (result) {
+ input.value = result.relativePath;
+ onChange(result.ref);
}
});
@@ -1356,53 +1281,36 @@ function createSpineSkinEditor(
}
// =============================================================================
-// Material File Editor
+// Generic Asset File Editor Factory
// =============================================================================
-function navigateToAsset(assetPath: string): void {
+interface AssetFileEditorConfig {
+ acceptTypes: string[];
+ dialogTitle: string;
+ filterName: string;
+ extensions: string[];
+}
+
+export function navigateToAsset(assetPath: string): void {
const editor = getEditorInstance();
if (editor && typeof editor.navigateToAsset === 'function') {
editor.navigateToAsset(assetPath);
}
}
-function createMaterialFileEditor(
- container: HTMLElement,
- ctx: PropertyEditorContext
-): PropertyEditorInstance {
- const { value, onChange } = ctx;
-
- const wrapper = document.createElement('div');
- wrapper.className = 'es-file-editor';
-
- const input = document.createElement('input');
- input.type = 'text';
- input.className = 'es-input es-input-file es-asset-link';
- input.value = resolveDisplayName(String(value ?? ''));
- input.placeholder = 'None';
- input.readOnly = true;
- checkAssetMissing(String(value ?? ''), input);
-
- const browseBtn = document.createElement('button');
- browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
- browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
-
- const clearBtn = document.createElement('button');
- clearBtn.className = 'es-btn es-btn-icon es-btn-clear';
- clearBtn.title = 'Clear';
- clearBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>`;
-
- input.addEventListener('click', () => {
- if (input.value) {
- navigateToAsset(input.value);
- }
- });
+export const BROWSE_ICON = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
+export const CLEAR_ICON = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>`;
+const ASSET_DRAG_MIME = 'application/esengine-asset';
+const ASSETS_DIR_NAME = 'assets';
+export function handleAssetDrop(
+ wrapper: HTMLElement,
+ acceptTypes: string[],
+ onAccept: (relativePath: string, ref: string) => void
+): void {
wrapper.addEventListener('dragover', (e) => {
e.preventDefault();
- const data = e.dataTransfer?.types.includes('application/esengine-asset');
- if (data) {
+ if (e.dataTransfer?.types.includes(ASSET_DRAG_MIME)) {
wrapper.classList.add('es-drag-over');
e.dataTransfer!.dropEffect = 'copy';
} else {
@@ -1417,85 +1325,59 @@ function createMaterialFileEditor(
wrapper.addEventListener('drop', (e) => {
e.preventDefault();
wrapper.classList.remove('es-drag-over');
-
- const jsonData = e.dataTransfer?.getData('application/esengine-asset');
+ const jsonData = e.dataTransfer?.getData(ASSET_DRAG_MIME);
if (!jsonData) return;
-
try {
const assetData = JSON.parse(jsonData);
- if (assetData.type === 'material') {
+ if (acceptTypes.includes(assetData.type)) {
const projectDir = getProjectDir();
if (projectDir && assetData.path.startsWith(projectDir)) {
const relativePath = assetData.path.substring(projectDir.length + 1);
const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
+ onAccept(relativePath, uuid ?? relativePath);
}
}
} catch (err) {
console.error('Failed to parse drop data:', err);
}
});
+}
- browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
-
- const assetsDir = `${projectDir}/assets`;
+export async function browseForAsset(
+ dialogTitle: string,
+ filterName: string,
+ extensions: string[]
+): Promise<{ relativePath: string; ref: string } | null> {
+ const projectDir = getProjectDir();
+ if (!projectDir) return null;
- try {
- const platform = getPlatformAdapter();
- const result = await platform.openFileDialog({
- title: 'Select Material',
- defaultPath: assetsDir,
- filters: [{ name: 'Material Files', extensions: ['esmaterial'] }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
+ const assetsDir = `${projectDir}/${ASSETS_DIR_NAME}`;
+ try {
+ const platform = getPlatformAdapter();
+ const result = await platform.openFileDialog({
+ title: dialogTitle,
+ defaultPath: assetsDir,
+ filters: [{ name: filterName, extensions }],
+ });
+ if (result) {
+ const normalizedPath = result.replace(/\\/g, '/');
+ const assetsIndex = normalizedPath.indexOf(`/${ASSETS_DIR_NAME}/`);
+ if (assetsIndex !== -1) {
+ const relativePath = normalizedPath.substring(assetsIndex + 1);
+ const uuid = getAssetLibrary().getUuid(relativePath);
+ return { relativePath, ref: uuid ?? relativePath };
}
- } catch (err) {
- console.error('Failed to open file dialog:', err);
}
- });
-
- clearBtn.addEventListener('click', () => {
- input.value = '';
- onChange('');
- });
-
- wrapper.appendChild(input);
- wrapper.appendChild(browseBtn);
- wrapper.appendChild(clearBtn);
- container.appendChild(wrapper);
-
- return {
- update(v: unknown) {
- const ref = String(v ?? '');
- input.value = resolveDisplayName(ref);
- checkAssetMissing(ref, input);
- },
- dispose() {
- wrapper.remove();
- },
- };
+ } catch (err) {
+ console.error('Failed to open file dialog:', err);
+ }
+ return null;
}
-// =============================================================================
-// Bitmap Font File Editor
-// =============================================================================
-
-function createBitmapFontFileEditor(
+function createAssetFileEditor(
container: HTMLElement,
- ctx: PropertyEditorContext
+ ctx: PropertyEditorContext,
+ config: AssetFileEditorConfig
): PropertyEditorInstance {
const { value, onChange } = ctx;
@@ -1513,84 +1395,27 @@ function createBitmapFontFileEditor(
const browseBtn = document.createElement('button');
browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
+ browseBtn.innerHTML = BROWSE_ICON;
const clearBtn = document.createElement('button');
clearBtn.className = 'es-btn es-btn-icon es-btn-clear';
clearBtn.title = 'Clear';
- clearBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>`;
+ clearBtn.innerHTML = CLEAR_ICON;
input.addEventListener('click', () => {
- if (input.value) {
- navigateToAsset(input.value);
- }
- });
-
- wrapper.addEventListener('dragover', (e) => {
- e.preventDefault();
- const data = e.dataTransfer?.types.includes('application/esengine-asset');
- if (data) {
- wrapper.classList.add('es-drag-over');
- e.dataTransfer!.dropEffect = 'copy';
- } else {
- e.dataTransfer!.dropEffect = 'none';
- }
- });
-
- wrapper.addEventListener('dragleave', () => {
- wrapper.classList.remove('es-drag-over');
+ if (input.value) navigateToAsset(input.value);
});
- wrapper.addEventListener('drop', (e) => {
- e.preventDefault();
- wrapper.classList.remove('es-drag-over');
-
- const jsonData = e.dataTransfer?.getData('application/esengine-asset');
- if (!jsonData) return;
-
- try {
- const assetData = JSON.parse(jsonData);
- if (assetData.type === 'font') {
- const projectDir = getProjectDir();
- if (projectDir && assetData.path.startsWith(projectDir)) {
- const relativePath = assetData.path.substring(projectDir.length + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
- }
- } catch (err) {
- console.error('Failed to parse drop data:', err);
- }
+ handleAssetDrop(wrapper, config.acceptTypes, (relativePath, ref) => {
+ input.value = relativePath;
+ onChange(ref);
});
browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
-
- const assetsDir = `${projectDir}/assets`;
-
- try {
- const platform = getPlatformAdapter();
- const result = await platform.openFileDialog({
- title: 'Select BitmapFont',
- defaultPath: assetsDir,
- filters: [{ name: 'BitmapFont Files', extensions: ['bmfont'] }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
- }
- } catch (err) {
- console.error('Failed to open file dialog:', err);
+ const result = await browseForAsset(config.dialogTitle, config.filterName, config.extensions);
+ if (result) {
+ input.value = result.relativePath;
+ onChange(result.ref);
}
});
@@ -1930,568 +1755,73 @@ function createStringArrayEditor(
}
// =============================================================================
-// Animation Clip File Editor
+// Asset File Editor Configs (data-driven via createAssetFileEditor)
+// =============================================================================
+
+const ASSET_FILE_EDITORS: Record<string, AssetFileEditorConfig> = {
+ 'material-file': { acceptTypes: [AssetType.MATERIAL], dialogTitle: 'Select Material', filterName: 'Material Files', extensions: ['esmaterial'] },
+ 'bitmap-font-file': { acceptTypes: [AssetType.FONT], dialogTitle: 'Select BitmapFont', filterName: 'BitmapFont Files', extensions: ['bmfont'] },
+ 'anim-file': { acceptTypes: [AssetType.ANIMCLIP], dialogTitle: 'Select Animation Clip', filterName: 'Animation Clip', extensions: ['esanim'] },
+ 'timeline-file': { acceptTypes: [AssetType.TIMELINE], dialogTitle: 'Select Timeline', filterName: 'Timeline', extensions: ['estimeline'] },
+ 'audio-file': { acceptTypes: [AssetType.AUDIO], dialogTitle: 'Select Audio File', filterName: 'Audio', extensions: ['mp3', 'wav', 'ogg'] },
+ 'tilemap-file': { acceptTypes: [AssetType.TILEMAP], dialogTitle: 'Select Tilemap', filterName: 'Tiled Map', extensions: ['tmj'] },
+};
+
+// =============================================================================
+// Collision Layer Editor
// =============================================================================
-function createAnimFileEditor(
+function createCollisionLayerEditor(
container: HTMLElement,
ctx: PropertyEditorContext
): PropertyEditorInstance {
const { value, onChange } = ctx;
- const wrapper = document.createElement('div');
- wrapper.className = 'es-file-editor';
-
- const input = document.createElement('input');
- input.type = 'text';
- input.className = 'es-input es-input-file es-asset-link';
- input.value = resolveDisplayName(String(value ?? ''));
- input.placeholder = 'None';
- input.readOnly = true;
- checkAssetMissing(String(value ?? ''), input);
-
- const browseBtn = document.createElement('button');
- browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
- browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
-
- const clearBtn = document.createElement('button');
- clearBtn.className = 'es-btn es-btn-icon es-btn-clear';
- clearBtn.title = 'Clear';
- clearBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>`;
+ const select = document.createElement('select');
+ select.className = 'es-input es-input-select';
- input.addEventListener('click', () => {
- if (input.value) {
- navigateToAsset(input.value);
+ function populateOptions(): void {
+ select.innerHTML = '';
+ const layers = getNamedLayers();
+ for (const layer of layers) {
+ const option = document.createElement('option');
+ option.value = String(layer.index);
+ option.textContent = `${layer.index}: ${layer.name}`;
+ select.appendChild(option);
}
- });
+ }
- wrapper.addEventListener('dragover', (e) => {
- e.preventDefault();
- const data = e.dataTransfer?.types.includes('application/esengine-asset');
- if (data) {
- wrapper.classList.add('es-drag-over');
- e.dataTransfer!.dropEffect = 'copy';
- } else {
- e.dataTransfer!.dropEffect = 'none';
- }
- });
+ populateOptions();
+ const currentIndex = layerIndexFromBits(value as number);
+ select.value = String(currentIndex);
- wrapper.addEventListener('dragleave', () => {
- wrapper.classList.remove('es-drag-over');
+ select.addEventListener('change', () => {
+ const idx = parseInt(select.value, 10);
+ onChange(bitsFromLayerIndex(idx));
});
- wrapper.addEventListener('drop', (e) => {
- e.preventDefault();
- wrapper.classList.remove('es-drag-over');
-
- const jsonData = e.dataTransfer?.getData('application/esengine-asset');
- if (!jsonData) return;
-
- try {
- const assetData = JSON.parse(jsonData);
- if (assetData.type === 'animclip') {
- const projectDir = getProjectDir();
- if (projectDir && assetData.path.startsWith(projectDir)) {
- const relativePath = assetData.path.substring(projectDir.length + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
- }
- } catch (err) {
- console.error('Failed to parse drop data:', err);
+ const unsubscribe = onSettingsChange((id) => {
+ if (id.startsWith('physics.layerName')) {
+ const prev = select.value;
+ populateOptions();
+ select.value = prev;
}
});
- browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
+ container.appendChild(select);
- const assetsDir = `${projectDir}/assets`;
-
- try {
- const platform = getPlatformAdapter();
- const result = await platform.openFileDialog({
- title: 'Select Animation Clip',
- defaultPath: assetsDir,
- filters: [{ name: 'Animation Clip', extensions: ['esanim'] }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
- }
- } catch (err) {
- console.error('Failed to open file dialog:', err);
- }
- });
-
- clearBtn.addEventListener('click', () => {
- input.value = '';
- onChange('');
- });
-
- wrapper.appendChild(input);
- wrapper.appendChild(browseBtn);
- wrapper.appendChild(clearBtn);
- container.appendChild(wrapper);
-
- return {
- update(v: unknown) {
- const ref = String(v ?? '');
- input.value = resolveDisplayName(ref);
- checkAssetMissing(ref, input);
- },
- dispose() {
- wrapper.remove();
- },
- };
-}
-
-// =============================================================================
-// Timeline File Editor
-// =============================================================================
-
-function createTimelineFileEditor(
- container: HTMLElement,
- ctx: PropertyEditorContext
-): PropertyEditorInstance {
- const { value, onChange } = ctx;
-
- const wrapper = document.createElement('div');
- wrapper.className = 'es-file-editor';
-
- const input = document.createElement('input');
- input.type = 'text';
- input.className = 'es-input es-input-file es-asset-link';
- input.value = resolveDisplayName(String(value ?? ''));
- input.placeholder = 'None';
- input.readOnly = true;
- checkAssetMissing(String(value ?? ''), input);
-
- const browseBtn = document.createElement('button');
- browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
- browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
-
- const clearBtn = document.createElement('button');
- clearBtn.className = 'es-btn es-btn-icon es-btn-clear';
- clearBtn.title = 'Clear';
- clearBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>`;
-
- input.addEventListener('click', () => {
- if (input.value) {
- navigateToAsset(input.value);
- }
- });
-
- wrapper.addEventListener('dragover', (e) => {
- e.preventDefault();
- const data = e.dataTransfer?.types.includes('application/esengine-asset');
- if (data) {
- wrapper.classList.add('es-drag-over');
- e.dataTransfer!.dropEffect = 'copy';
- } else {
- e.dataTransfer!.dropEffect = 'none';
- }
- });
-
- wrapper.addEventListener('dragleave', () => {
- wrapper.classList.remove('es-drag-over');
- });
-
- wrapper.addEventListener('drop', (e) => {
- e.preventDefault();
- wrapper.classList.remove('es-drag-over');
-
- const jsonData = e.dataTransfer?.getData('application/esengine-asset');
- if (!jsonData) return;
-
- try {
- const assetData = JSON.parse(jsonData);
- if (assetData.type === 'timeline') {
- const projectDir = getProjectDir();
- if (projectDir && assetData.path.startsWith(projectDir)) {
- const relativePath = assetData.path.substring(projectDir.length + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
- }
- } catch (err) {
- console.error('Failed to parse drop data:', err);
- }
- });
-
- browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
-
- const assetsDir = `${projectDir}/assets`;
-
- try {
- const platform = getPlatformAdapter();
- const result = await platform.openFileDialog({
- title: 'Select Timeline',
- defaultPath: assetsDir,
- filters: [{ name: 'Timeline', extensions: ['estimeline'] }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
- }
- } catch (err) {
- console.error('Failed to open file dialog:', err);
- }
- });
-
- clearBtn.addEventListener('click', () => {
- input.value = '';
- onChange('');
- });
-
- wrapper.appendChild(input);
- wrapper.appendChild(browseBtn);
- wrapper.appendChild(clearBtn);
- container.appendChild(wrapper);
-
- return {
- update(v: unknown) {
- const ref = String(v ?? '');
- input.value = resolveDisplayName(ref);
- checkAssetMissing(ref, input);
- },
- dispose() {
- wrapper.remove();
- },
- };
-}
-
-// =============================================================================
-// Audio File Editor
-// =============================================================================
-
-function createAudioFileEditor(
- container: HTMLElement,
- ctx: PropertyEditorContext
-): PropertyEditorInstance {
- const { value, onChange } = ctx;
-
- const wrapper = document.createElement('div');
- wrapper.className = 'es-file-editor';
-
- const input = document.createElement('input');
- input.type = 'text';
- input.className = 'es-input es-input-file es-asset-link';
- input.value = resolveDisplayName(String(value ?? ''));
- input.placeholder = 'None';
- input.readOnly = true;
- checkAssetMissing(String(value ?? ''), input);
-
- const browseBtn = document.createElement('button');
- browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
- browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
-
- const clearBtn = document.createElement('button');
- clearBtn.className = 'es-btn es-btn-icon es-btn-clear';
- clearBtn.title = 'Clear';
- clearBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>`;
-
- input.addEventListener('click', () => {
- if (input.value) {
- navigateToAsset(input.value);
- }
- });
-
- wrapper.addEventListener('dragover', (e) => {
- e.preventDefault();
- const data = e.dataTransfer?.types.includes('application/esengine-asset');
- if (data) {
- wrapper.classList.add('es-drag-over');
- e.dataTransfer!.dropEffect = 'copy';
- } else {
- e.dataTransfer!.dropEffect = 'none';
- }
- });
-
- wrapper.addEventListener('dragleave', () => {
- wrapper.classList.remove('es-drag-over');
- });
-
- wrapper.addEventListener('drop', (e) => {
- e.preventDefault();
- wrapper.classList.remove('es-drag-over');
-
- const jsonData = e.dataTransfer?.getData('application/esengine-asset');
- if (!jsonData) return;
-
- try {
- const assetData = JSON.parse(jsonData);
- if (assetData.type === 'audio') {
- const projectDir = getProjectDir();
- if (projectDir && assetData.path.startsWith(projectDir)) {
- const relativePath = assetData.path.substring(projectDir.length + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
- }
- } catch (err) {
- console.error('Failed to parse drop data:', err);
- }
- });
-
- browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
-
- const assetsDir = `${projectDir}/assets`;
-
- try {
- const platform = getPlatformAdapter();
- const result = await platform.openFileDialog({
- title: 'Select Audio File',
- defaultPath: assetsDir,
- filters: [{ name: 'Audio', extensions: ['mp3', 'wav', 'ogg'] }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
- }
- } catch (err) {
- console.error('Failed to open file dialog:', err);
- }
- });
-
- clearBtn.addEventListener('click', () => {
- input.value = '';
- onChange('');
- });
-
- wrapper.appendChild(input);
- wrapper.appendChild(browseBtn);
- wrapper.appendChild(clearBtn);
- container.appendChild(wrapper);
-
- return {
- update(v: unknown) {
- const ref = String(v ?? '');
- input.value = resolveDisplayName(ref);
- checkAssetMissing(ref, input);
- },
- dispose() {
- wrapper.remove();
- },
- };
-}
-
-// =============================================================================
-// Tilemap File Editor
-// =============================================================================
-
-function createTilemapFileEditor(
- container: HTMLElement,
- ctx: PropertyEditorContext
-): PropertyEditorInstance {
- const { value, onChange } = ctx;
-
- const wrapper = document.createElement('div');
- wrapper.className = 'es-file-editor';
-
- const input = document.createElement('input');
- input.type = 'text';
- input.className = 'es-input es-input-file es-asset-link';
- input.value = resolveDisplayName(String(value ?? ''));
- input.placeholder = 'None';
- input.readOnly = true;
- checkAssetMissing(String(value ?? ''), input);
-
- const browseBtn = document.createElement('button');
- browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
- browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
-
- const clearBtn = document.createElement('button');
- clearBtn.className = 'es-btn es-btn-icon es-btn-clear';
- clearBtn.title = 'Clear';
- clearBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>`;
-
- input.addEventListener('click', () => {
- if (input.value) {
- navigateToAsset(input.value);
- }
- });
-
- wrapper.addEventListener('dragover', (e) => {
- e.preventDefault();
- const data = e.dataTransfer?.types.includes('application/esengine-asset');
- if (data) {
- wrapper.classList.add('es-drag-over');
- e.dataTransfer!.dropEffect = 'copy';
- } else {
- e.dataTransfer!.dropEffect = 'none';
- }
- });
-
- wrapper.addEventListener('dragleave', () => {
- wrapper.classList.remove('es-drag-over');
- });
-
- wrapper.addEventListener('drop', (e) => {
- e.preventDefault();
- wrapper.classList.remove('es-drag-over');
-
- const jsonData = e.dataTransfer?.getData('application/esengine-asset');
- if (!jsonData) return;
-
- try {
- const assetData = JSON.parse(jsonData);
- if (assetData.type === 'tilemap') {
- const projectDir = getProjectDir();
- if (projectDir && assetData.path.startsWith(projectDir)) {
- const relativePath = assetData.path.substring(projectDir.length + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
- }
- } catch (err) {
- console.error('Failed to parse drop data:', err);
- }
- });
-
- browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
-
- const assetsDir = `${projectDir}/assets`;
-
- try {
- const platform = getPlatformAdapter();
- const result = await platform.openFileDialog({
- title: 'Select Tilemap',
- defaultPath: assetsDir,
- filters: [{ name: 'Tiled Map', extensions: ['tmj'] }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- const uuid = getAssetLibrary().getUuid(relativePath);
- const ref = uuid ?? relativePath;
- input.value = relativePath;
- onChange(ref);
- }
- }
- } catch (err) {
- console.error('Failed to open file dialog:', err);
- }
- });
-
- clearBtn.addEventListener('click', () => {
- input.value = '';
- onChange('');
- });
-
- wrapper.appendChild(input);
- wrapper.appendChild(browseBtn);
- wrapper.appendChild(clearBtn);
- container.appendChild(wrapper);
-
- return {
- update(v: unknown) {
- const ref = String(v ?? '');
- input.value = resolveDisplayName(ref);
- checkAssetMissing(ref, input);
- },
- dispose() {
- wrapper.remove();
- },
- };
-}
-
-// =============================================================================
-// Collision Layer Editor
-// =============================================================================
-
-function createCollisionLayerEditor(
- container: HTMLElement,
- ctx: PropertyEditorContext
-): PropertyEditorInstance {
- const { value, onChange } = ctx;
-
- const select = document.createElement('select');
- select.className = 'es-input es-input-select';
-
- function populateOptions(): void {
- select.innerHTML = '';
- const layers = getNamedLayers();
- for (const layer of layers) {
- const option = document.createElement('option');
- option.value = String(layer.index);
- option.textContent = `${layer.index}: ${layer.name}`;
- select.appendChild(option);
- }
- }
-
- populateOptions();
- const currentIndex = layerIndexFromBits(value as number);
- select.value = String(currentIndex);
-
- select.addEventListener('change', () => {
- const idx = parseInt(select.value, 10);
- onChange(bitsFromLayerIndex(idx));
- });
-
- const unsubscribe = onSettingsChange((id) => {
- if (id.startsWith('physics.layerName')) {
- const prev = select.value;
- populateOptions();
- select.value = prev;
- }
- });
-
- container.appendChild(select);
-
- return {
- update(newValue: unknown) {
- populateOptions();
- const idx = layerIndexFromBits(newValue as number);
- select.value = String(idx);
- },
- dispose() {
- unsubscribe();
- select.remove();
- },
- };
-}
+ return {
+ update(newValue: unknown) {
+ populateOptions();
+ const idx = layerIndexFromBits(newValue as number);
+ select.value = String(idx);
+ },
+ dispose() {
+ unsubscribe();
+ select.remove();
+ },
+ };
+}
// =============================================================================
// Register All Editors
@@ -2513,16 +1843,13 @@ export function registerBuiltinEditors(): void {
registerPropertyEditor('spine-file', createSpineFileEditor);
registerPropertyEditor('spine-animation', createSpineAnimationEditor);
registerPropertyEditor('spine-skin', createSpineSkinEditor);
- registerPropertyEditor('material-file', createMaterialFileEditor);
- registerPropertyEditor('bitmap-font-file', createBitmapFontFileEditor);
+ for (const [editorType, config] of Object.entries(ASSET_FILE_EDITORS)) {
+ registerPropertyEditor(editorType, (container, ctx) => createAssetFileEditor(container, ctx, config));
+ }
registerPropertyEditor('uirect', createUIRectEditor);
registerPropertyEditor('button-transition', createButtonTransitionEditor);
registerPropertyEditor('entity', createEntityEditor);
registerPropertyEditor('string-array', createStringArrayEditor);
registerPropertyEditor('vec2-array', createVec2ArrayEditor);
- registerPropertyEditor('anim-file', createAnimFileEditor);
- registerPropertyEditor('audio-file', createAudioFileEditor);
- registerPropertyEditor('timeline-file', createTimelineFileEditor);
- registerPropertyEditor('tilemap-file', createTilemapFileEditor);
registerPropertyEditor('collision-layer', createCollisionLayerEditor);
}
diff --git a/editor/src/property/materialEditors.ts b/editor/src/property/materialEditors.ts
index 770e5856e..28a59e0ad 100644
--- a/editor/src/property/materialEditors.ts
+++ b/editor/src/property/materialEditors.ts
@@ -9,28 +9,16 @@ import {
type PropertyEditorInstance,
} from './PropertyEditor';
import { BLEND_MODE_OPTIONS } from '../types/MaterialMetadata';
-import { getAssetMimeType } from 'esengine';
-import { getPlatformAdapter } from '../platform/PlatformAdapter';
-import { getEditorContext, getEditorInstance } from '../context/EditorContext';
-import type { NativeFS } from '../types/NativeFS';
-
-// =============================================================================
-// Helpers
-// =============================================================================
-
-function getProjectDir(): string | null {
- const editor = getEditorInstance();
- const projectPath = editor?.projectPath;
- if (!projectPath) return null;
- return projectPath.replace(/\\/g, '/').replace(/\/[^/]+$/, '');
-}
-
-function navigateToAsset(assetPath: string): void {
- const editor = getEditorInstance();
- if (editor && typeof editor.navigateToAsset === 'function') {
- editor.navigateToAsset(assetPath);
- }
-}
+import {
+ getProjectDir,
+ getNativeFS,
+ getMimeType,
+ navigateToAsset,
+ handleAssetDrop,
+ browseForAsset,
+ BROWSE_ICON,
+} from './editors';
+import { AssetType } from '../constants/AssetTypes';
// =============================================================================
// Blend Mode Editor
@@ -94,75 +82,22 @@ function createShaderFileEditor(
const browseBtn = document.createElement('button');
browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
+ browseBtn.innerHTML = BROWSE_ICON;
input.addEventListener('click', () => {
- if (input.value) {
- navigateToAsset(input.value);
- }
+ if (input.value) navigateToAsset(input.value);
});
- wrapper.addEventListener('dragover', (e) => {
- e.preventDefault();
- const data = e.dataTransfer?.types.includes('application/esengine-asset');
- if (data) {
- wrapper.classList.add('es-drag-over');
- e.dataTransfer!.dropEffect = 'copy';
- } else {
- e.dataTransfer!.dropEffect = 'none';
- }
- });
-
- wrapper.addEventListener('dragleave', () => {
- wrapper.classList.remove('es-drag-over');
- });
-
- wrapper.addEventListener('drop', (e) => {
- e.preventDefault();
- wrapper.classList.remove('es-drag-over');
-
- const jsonData = e.dataTransfer?.getData('application/esengine-asset');
- if (!jsonData) return;
-
- try {
- const assetData = JSON.parse(jsonData);
- if (assetData.type === 'shader') {
- const projectDir = getProjectDir();
- if (projectDir && assetData.path.startsWith(projectDir)) {
- const relativePath = assetData.path.substring(projectDir.length + 1);
- input.value = relativePath;
- onChange(relativePath);
- }
- }
- } catch (err) {
- console.error('Failed to parse drop data:', err);
- }
+ handleAssetDrop(wrapper, [AssetType.SHADER], (relativePath) => {
+ input.value = relativePath;
+ onChange(relativePath);
});
browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
-
- const assetsDir = `${projectDir}/assets`;
-
- try {
- const platform = getPlatformAdapter();
- const result = await platform.openFileDialog({
- title: 'Select Shader',
- defaultPath: assetsDir,
- filters: [{ name: 'Shader Files', extensions: ['esshader'] }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- input.value = relativePath;
- onChange(relativePath);
- }
- }
- } catch (err) {
- console.error('Failed to open file dialog:', err);
+ const result = await browseForAsset('Select Shader', 'Shader Files', ['esshader']);
+ if (result) {
+ input.value = result.relativePath;
+ onChange(result.relativePath);
}
});
@@ -184,15 +119,6 @@ function createShaderFileEditor(
// Material Texture Editor
// =============================================================================
-function getNativeFS(): NativeFS | null {
- return getEditorContext().fs ?? null;
-}
-
-function getMimeType(path: string): string {
- const ext = path.split('.').pop()?.toLowerCase() ?? '';
- return getAssetMimeType(ext) ?? 'image/png';
-}
-
function createMaterialTextureEditor(
container: HTMLElement,
ctx: PropertyEditorContext
@@ -225,7 +151,7 @@ function createMaterialTextureEditor(
const browseBtn = document.createElement('button');
browseBtn.className = 'es-btn es-btn-icon es-btn-browse';
browseBtn.title = 'Browse';
- browseBtn.innerHTML = `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 7v10a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-6l-2-2H5a2 2 0 0 0-2 2z"></path></svg>`;
+ browseBtn.innerHTML = BROWSE_ICON;
const updatePreview = async (texturePath: string) => {
const gen = ++previewGeneration;
@@ -271,71 +197,20 @@ function createMaterialTextureEditor(
}
});
- wrapper.addEventListener('dragover', (e) => {
- e.preventDefault();
- const data = e.dataTransfer?.types.includes('application/esengine-asset');
- if (data) {
- wrapper.classList.add('es-drag-over');
- e.dataTransfer!.dropEffect = 'copy';
- } else {
- e.dataTransfer!.dropEffect = 'none';
- }
- });
-
- wrapper.addEventListener('dragleave', () => {
- wrapper.classList.remove('es-drag-over');
- });
-
- wrapper.addEventListener('drop', (e) => {
- e.preventDefault();
- wrapper.classList.remove('es-drag-over');
-
- const jsonData = e.dataTransfer?.getData('application/esengine-asset');
- if (!jsonData) return;
-
- try {
- const assetData = JSON.parse(jsonData);
- if (assetData.type === 'image') {
- const projectDir = getProjectDir();
- if (projectDir && assetData.path.startsWith(projectDir)) {
- const relativePath = assetData.path.substring(projectDir.length + 1);
- input.value = relativePath;
- currentRef = relativePath;
- onChange(relativePath);
- updatePreview(relativePath);
- }
- }
- } catch (err) {
- console.error('Failed to parse drop data:', err);
- }
+ handleAssetDrop(wrapper, [AssetType.IMAGE], (relativePath) => {
+ input.value = relativePath;
+ currentRef = relativePath;
+ onChange(relativePath);
+ updatePreview(relativePath);
});
browseBtn.addEventListener('click', async () => {
- const projectDir = getProjectDir();
- if (!projectDir) return;
-
- const assetsDir = `${projectDir}/assets`;
-
- try {
- const platform = getPlatformAdapter();
- const result = await platform.openFileDialog({
- title: 'Select Texture',
- defaultPath: assetsDir,
- filters: [{ name: 'Images', extensions: ['png', 'jpg', 'jpeg', 'webp'] }],
- });
- if (result) {
- const normalizedPath = result.replace(/\\/g, '/');
- const assetsIndex = normalizedPath.indexOf('/assets/');
- if (assetsIndex !== -1) {
- const relativePath = normalizedPath.substring(assetsIndex + 1);
- input.value = relativePath;
- currentRef = relativePath;
- onChange(relativePath);
- updatePreview(relativePath);
- }
- }
- } catch (err) {
- console.error('Failed to open file dialog:', err);
+ const result = await browseForAsset('Select Texture', 'Images', ['png', 'jpg', 'jpeg', 'webp']);
+ if (result) {
+ input.value = result.relativePath;
+ currentRef = result.relativePath;
+ onChange(result.relativePath);
+ updatePreview(result.relativePath);
}
});
diff --git a/editor/src/schemas/ComponentSchemas.ts b/editor/src/schemas/ComponentSchemas.ts
index be154dc18..a19ce1eb9 100644
--- a/editor/src/schemas/ComponentSchemas.ts
+++ b/editor/src/schemas/ComponentSchemas.ts
@@ -1,8 +1,3 @@
-/**
- * @file ComponentSchemas.ts
- * @brief Component property schemas for the inspector
- */
-
import type { PropertyMeta } from '../property/PropertyEditor';
import { getComponentDefaults } from 'esengine';
import { getSettingsValue } from '../settings/SettingsRegistry';
@@ -31,17 +26,6 @@ function isVec2(v: unknown): boolean {
'x' in v && 'y' in v && !('z' in v);
}
-function isVec3(v: unknown): boolean {
- return typeof v === 'object' && v !== null &&
- 'x' in v && 'y' in v && 'z' in v && !('w' in v);
-}
-
-function isVec4OrColor(v: unknown): boolean {
- if (typeof v !== 'object' || v === null) return false;
- if ('r' in v && 'g' in v && 'b' in v && 'a' in v) return true;
- return 'x' in v && 'y' in v && 'z' in v && 'w' in v;
-}
-
export function inferPropertyType(value: unknown): string {
if (typeof value === 'number') return 'number';
if (typeof value === 'string') return 'string';
@@ -51,7 +35,8 @@ export function inferPropertyType(value: unknown): string {
return 'string-array';
}
if (isVec2(value)) return 'vec2';
- if (isVec3(value)) return 'vec3';
+ if (typeof value === 'object' && value !== null &&
+ 'x' in value && 'y' in value && 'z' in value && !('w' in value)) return 'vec3';
if (typeof value === 'object' && value !== null) {
if ('r' in value && 'g' in value && 'b' in value && 'a' in value) return 'color';
if ('x' in value && 'y' in value && 'z' in value && 'w' in value) return 'vec4';
@@ -59,860 +44,6 @@ export function inferPropertyType(value: unknown): string {
return 'string';
}
-// =============================================================================
-// Built-in Schemas
-// =============================================================================
-
-export const NameSchema: ComponentSchema = {
- name: 'Name',
- category: 'builtin',
- removable: false,
- properties: [
- { name: 'value', type: 'string' },
- ],
-};
-
-export const ParentSchema: ComponentSchema = {
- name: 'Parent',
- category: 'builtin',
- removable: false,
- properties: [
- { name: 'entity', type: 'entity' },
- ],
-};
-
-export const ChildrenSchema: ComponentSchema = {
- name: 'Children',
- category: 'tag',
- removable: false,
- properties: [],
-};
-
-export const TransformSchema: ComponentSchema = {
- name: 'Transform',
- category: 'builtin',
- removable: false,
- properties: [
- { name: 'position', type: 'vec3' },
- { name: 'rotation', type: 'euler' },
- { name: 'scale', type: 'vec3' },
- ],
-};
-
-export const SpriteSchema: ComponentSchema = {
- name: 'Sprite',
- category: 'builtin',
- properties: [
- { name: 'texture', type: 'texture' },
- { name: 'material', type: 'material-file' },
- { name: 'color', type: 'color' },
- { name: 'size', type: 'vec2', hiddenWhen: { hasComponent: 'UIRect' } },
- { name: 'uvOffset', type: 'vec2' },
- { name: 'uvScale', type: 'vec2' },
- { name: 'layer', type: 'number', min: -1000, max: 1000 },
- { name: 'flipX', type: 'boolean' },
- { name: 'flipY', type: 'boolean' },
- ],
-};
-
-export const ShapeRendererSchema: ComponentSchema = {
- name: 'ShapeRenderer',
- category: 'builtin',
- properties: [
- {
- name: 'shapeType',
- type: 'enum',
- options: [
- { label: 'Circle', value: 0 },
- { label: 'Capsule', value: 1 },
- { label: 'RoundedRect', value: 2 },
- ],
- },
- { name: 'color', type: 'color' },
- { name: 'size', type: 'vec2' },
- { name: 'cornerRadius', type: 'number', min: 0 },
- { name: 'layer', type: 'number', min: -1000, max: 1000 },
- ],
-};
-
-export const CameraSchema: ComponentSchema = {
- name: 'Camera',
- category: 'builtin',
- properties: [
- { name: 'isActive', type: 'boolean' },
- {
- name: 'projectionType',
- type: 'enum',
- options: [
- { label: 'Perspective', value: 0 },
- { label: 'Orthographic', value: 1 },
- ],
- },
- { name: 'fov', type: 'number', min: 1, max: 179 },
- { name: 'orthoSize', type: 'number', min: 0.1 },
- { name: 'nearPlane', type: 'number', step: 0.1 },
- { name: 'farPlane', type: 'number', step: 1 },
- { name: 'priority', type: 'number', step: 1 },
- { name: 'viewportX', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'viewportY', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'viewportW', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'viewportH', type: 'number', min: 0, max: 1, step: 0.01 },
- {
- name: 'clearFlags',
- type: 'enum',
- options: [
- { label: 'None', value: 0 },
- { label: 'Color Only', value: 1 },
- { label: 'Depth Only', value: 2 },
- { label: 'Color + Depth', value: 3 },
- ],
- },
- { name: 'showFrustum', type: 'boolean' },
- ],
-};
-
-export const TextSchema: ComponentSchema = {
- name: 'Text',
- category: 'ui',
- properties: [
- { name: 'content', type: 'string' },
- { name: 'fontFamily', type: 'font' },
- { name: 'fontSize', type: 'number', min: 8, max: 200 },
- { name: 'color', type: 'color' },
- {
- name: 'align',
- type: 'enum',
- options: [
- { label: 'Left', value: 0 },
- { label: 'Center', value: 1 },
- { label: 'Right', value: 2 },
- ],
- },
- {
- name: 'verticalAlign',
- type: 'enum',
- options: [
- { label: 'Top', value: 0 },
- { label: 'Middle', value: 1 },
- { label: 'Bottom', value: 2 },
- ],
- },
- { name: 'wordWrap', type: 'boolean' },
- {
- name: 'overflow',
- type: 'enum',
- options: [
- { label: 'Visible', value: 0 },
- { label: 'Clip', value: 1 },
- { label: 'Ellipsis', value: 2 },
- ],
- },
- { name: 'lineHeight', type: 'number', min: 0.5, max: 3, step: 0.1 },
- ],
-};
-
-export const UIRectSchema: ComponentSchema = {
- name: 'UIRect',
- category: 'ui',
- properties: [
- { name: '*', type: 'uirect' },
- ],
-};
-
-export const CanvasSchema: ComponentSchema = {
- name: 'Canvas',
- category: 'builtin',
- properties: [
- { name: 'designResolution', type: 'vec2' },
- { name: 'pixelsPerUnit', type: 'number', min: 1, step: 1 },
- {
- name: 'scaleMode',
- type: 'enum',
- options: [
- { label: 'FixedWidth', value: 0 },
- { label: 'FixedHeight', value: 1 },
- { label: 'Expand', value: 2 },
- { label: 'Shrink', value: 3 },
- { label: 'Match', value: 4 },
- ],
- },
- { name: 'matchWidthOrHeight', type: 'number', min: 0, max: 1, step: 0.1 },
- { name: 'backgroundColor', type: 'color' },
- ],
-};
-
-export const BitmapTextSchema: ComponentSchema = {
- name: 'BitmapText',
- category: 'ui',
- properties: [
- { name: 'text', type: 'string' },
- { name: 'font', type: 'bitmap-font-file' },
- { name: 'color', type: 'color' },
- { name: 'fontSize', type: 'number', min: 0.1, step: 0.1 },
- {
- name: 'align',
- type: 'enum',
- options: [
- { label: 'Left', value: 0 },
- { label: 'Center', value: 1 },
- { label: 'Right', value: 2 },
- ],
- },
- { name: 'spacing', type: 'number', step: 0.1 },
- { name: 'layer', type: 'number', min: -1000, max: 1000 },
- ],
-};
-
-export const UIMaskSchema: ComponentSchema = {
- name: 'UIMask',
- category: 'ui',
- properties: [
- { name: 'enabled', type: 'boolean' },
- {
- name: 'mode',
- type: 'enum',
- options: [
- { label: 'Scissor', value: 0 },
- { label: 'Stencil', value: 1 },
- ],
- },
- ],
-};
-
-export const InteractableSchema: ComponentSchema = {
- name: 'Interactable',
- category: 'ui',
- properties: [
- { name: 'enabled', type: 'boolean' },
- { name: 'blockRaycast', type: 'boolean' },
- { name: 'raycastTarget', type: 'boolean' },
- ],
-};
-
-export const ButtonSchema: ComponentSchema = {
- name: 'Button',
- category: 'ui',
- properties: [
- {
- name: 'state',
- type: 'enum',
- options: [
- { label: 'Normal', value: 0 },
- { label: 'Hovered', value: 1 },
- { label: 'Pressed', value: 2 },
- { label: 'Disabled', value: 3 },
- ],
- },
- { name: 'transition', type: 'button-transition' },
- ],
-};
-
-export const TextInputSchema: ComponentSchema = {
- name: 'TextInput',
- category: 'ui',
- properties: [
- { name: 'value', type: 'string' },
- { name: 'placeholder', type: 'string' },
- { name: 'placeholderColor', type: 'color' },
- { name: 'fontFamily', type: 'font' },
- { name: 'fontSize', type: 'number', min: 8, max: 200 },
- { name: 'color', type: 'color' },
- { name: 'backgroundColor', type: 'color' },
- { name: 'padding', type: 'number', min: 0, step: 1 },
- { name: 'maxLength', type: 'number', min: 0, step: 1 },
- { name: 'multiline', type: 'boolean' },
- { name: 'password', type: 'boolean' },
- { name: 'readOnly', type: 'boolean' },
- ],
-};
-
-export const VelocitySchema: ComponentSchema = {
- name: 'Velocity',
- category: 'builtin',
- properties: [
- { name: 'linear', type: 'vec3' },
- { name: 'angular', type: 'vec3' },
- ],
-};
-
-export const SceneOwnerSchema: ComponentSchema = {
- name: 'SceneOwner',
- category: 'builtin',
- removable: false,
- properties: [
- { name: 'scene', type: 'string' },
- { name: 'persistent', type: 'boolean' },
- ],
-};
-
-export const SpineAnimationSchema: ComponentSchema = {
- name: 'SpineAnimation',
- category: 'builtin',
- properties: [
- { name: 'skeletonPath', type: 'spine-file', fileFilter: ['.json', '.skel'] },
- { name: 'atlasPath', type: 'spine-file', fileFilter: ['.atlas'] },
- { name: 'material', type: 'material-file' },
- { name: 'skin', type: 'spine-skin', dependsOn: 'skeletonPath' },
- { name: 'animation', type: 'spine-animation', dependsOn: 'skeletonPath' },
- { name: 'timeScale', type: 'number', min: 0, max: 10, step: 0.1 },
- { name: 'loop', type: 'boolean' },
- { name: 'playing', type: 'boolean' },
- { name: 'flipX', type: 'boolean' },
- { name: 'flipY', type: 'boolean' },
- { name: 'color', type: 'color' },
- { name: 'layer', type: 'number', min: -1000, max: 1000 },
- { name: 'skeletonScale', type: 'number', min: 0.01, max: 100, step: 0.01 },
- ],
-};
-
-export const SpriteAnimatorSchema: ComponentSchema = {
- name: 'SpriteAnimator',
- category: 'builtin',
- properties: [
- { name: 'clip', type: 'anim-file' },
- { name: 'speed', type: 'number', min: 0, max: 10, step: 0.1 },
- { name: 'playing', type: 'boolean' },
- { name: 'loop', type: 'boolean' },
- { name: 'enabled', type: 'boolean' },
- ],
-};
-
-export const AudioSourceSchema: ComponentSchema = {
- name: 'AudioSource',
- category: 'builtin',
- properties: [
- { name: 'clip', type: 'audio-file' },
- { name: 'bus', type: 'enum', options: [
- { label: 'SFX', value: 'sfx' },
- { label: 'Music', value: 'music' },
- { label: 'UI', value: 'ui' },
- { label: 'Voice', value: 'voice' },
- ]},
- { name: 'volume', type: 'number', min: 0, max: 1, step: 0.05 },
- { name: 'pitch', type: 'number', min: 0.1, max: 3, step: 0.1 },
- { name: 'loop', type: 'boolean' },
- { name: 'playOnAwake', type: 'boolean' },
- { name: 'spatial', type: 'boolean' },
- { name: 'minDistance', type: 'number', min: 0, step: 10 },
- { name: 'maxDistance', type: 'number', min: 0, step: 10 },
- { name: 'attenuationModel', type: 'enum', options: [
- { label: 'Linear', value: 0 },
- { label: 'Inverse', value: 1 },
- { label: 'Exponential', value: 2 },
- ]},
- { name: 'rolloff', type: 'number', min: 0, max: 5, step: 0.1 },
- { name: 'priority', type: 'number', min: 0, step: 1 },
- { name: 'enabled', type: 'boolean' },
- ],
-};
-
-export const AudioListenerSchema: ComponentSchema = {
- name: 'AudioListener',
- category: 'builtin',
- properties: [
- { name: 'enabled', type: 'boolean' },
- ],
-};
-
-export const RigidBodySchema: ComponentSchema = {
- name: 'RigidBody',
- category: 'physics',
- properties: [
- { name: 'bodyType', type: 'enum', options: [
- { label: 'Static', value: 0 },
- { label: 'Kinematic', value: 1 },
- { label: 'Dynamic', value: 2 },
- ]},
- { name: 'gravityScale', type: 'number', step: 0.1 },
- { name: 'linearDamping', type: 'number', min: 0, step: 0.1 },
- { name: 'angularDamping', type: 'number', min: 0, step: 0.1 },
- { name: 'fixedRotation', type: 'boolean' },
- { name: 'bullet', type: 'boolean' },
- { name: 'enabled', type: 'boolean' },
- ],
-};
-
-export const BoxColliderSchema: ComponentSchema = {
- name: 'BoxCollider',
- category: 'physics',
- properties: [
- { name: 'halfExtents', type: 'vec2' },
- { name: 'offset', type: 'vec2' },
- { name: 'radius', type: 'number', min: 0, step: 0.01 },
- { name: 'density', type: 'number', min: 0, step: 0.1 },
- { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'isSensor', type: 'boolean' },
- { name: 'categoryBits', type: 'collision-layer' },
- ],
-};
-
-export const CircleColliderSchema: ComponentSchema = {
- name: 'CircleCollider',
- category: 'physics',
- properties: [
- { name: 'radius', type: 'number', min: 0, step: 0.01 },
- { name: 'offset', type: 'vec2' },
- { name: 'density', type: 'number', min: 0, step: 0.1 },
- { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'isSensor', type: 'boolean' },
- { name: 'categoryBits', type: 'collision-layer' },
- ],
-};
-
-export const CapsuleColliderSchema: ComponentSchema = {
- name: 'CapsuleCollider',
- category: 'physics',
- properties: [
- { name: 'radius', type: 'number', min: 0, step: 0.01 },
- { name: 'halfHeight', type: 'number', min: 0, step: 0.01 },
- { name: 'offset', type: 'vec2' },
- { name: 'density', type: 'number', min: 0, step: 0.1 },
- { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'isSensor', type: 'boolean' },
- { name: 'categoryBits', type: 'collision-layer' },
- ],
-};
-
-export const SegmentColliderSchema: ComponentSchema = {
- name: 'SegmentCollider',
- category: 'physics',
- properties: [
- { name: 'point1', type: 'vec2' },
- { name: 'point2', type: 'vec2' },
- { name: 'density', type: 'number', min: 0, step: 0.1 },
- { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'isSensor', type: 'boolean' },
- { name: 'categoryBits', type: 'collision-layer' },
- ],
-};
-
-export const PolygonColliderSchema: ComponentSchema = {
- name: 'PolygonCollider',
- category: 'physics',
- properties: [
- { name: 'vertices', type: 'vec2-array', max: 8 },
- { name: 'radius', type: 'number', min: 0, step: 0.01 },
- { name: 'density', type: 'number', min: 0, step: 0.1 },
- { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'isSensor', type: 'boolean' },
- { name: 'categoryBits', type: 'collision-layer' },
- ],
-};
-
-export const ChainColliderSchema: ComponentSchema = {
- name: 'ChainCollider',
- category: 'physics',
- properties: [
- { name: 'points', type: 'vec2-array' },
- { name: 'isLoop', type: 'boolean' },
- { name: 'friction', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'restitution', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'categoryBits', type: 'collision-layer' },
- ],
-};
-
-export const RevoluteJointSchema: ComponentSchema = {
- name: 'RevoluteJoint',
- category: 'physics',
- properties: [
- { name: 'connectedEntity', type: 'entity' },
- { name: 'anchorA', type: 'vec2' },
- { name: 'anchorB', type: 'vec2' },
- { name: 'enableMotor', type: 'boolean' },
- { name: 'motorSpeed', type: 'number', step: 0.1 },
- { name: 'maxMotorTorque', type: 'number', min: 0, step: 1 },
- { name: 'enableLimit', type: 'boolean' },
- { name: 'lowerAngle', type: 'number', step: 0.01 },
- { name: 'upperAngle', type: 'number', step: 0.01 },
- { name: 'collideConnected', type: 'boolean' },
- { name: 'enabled', type: 'boolean' },
- ],
-};
-
-export const ImageSchema: ComponentSchema = {
- name: 'Image',
- category: 'ui',
- properties: [
- { name: 'texture', type: 'texture' },
- { name: 'material', type: 'material-file' },
- { name: 'color', type: 'color' },
- {
- name: 'imageType',
- type: 'enum',
- options: [
- { label: 'Simple', value: 0 },
- { label: 'Sliced', value: 1 },
- { label: 'Tiled', value: 2 },
- { label: 'Filled', value: 3 },
- ],
- },
- {
- name: 'fillMethod',
- type: 'enum',
- options: [
- { label: 'Horizontal', value: 0 },
- { label: 'Vertical', value: 1 },
- ],
- },
- {
- name: 'fillOrigin',
- type: 'enum',
- options: [
- { label: 'Left', value: 0 },
- { label: 'Right', value: 1 },
- { label: 'Bottom', value: 2 },
- { label: 'Top', value: 3 },
- ],
- },
- { name: 'fillAmount', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'preserveAspect', type: 'boolean' },
- { name: 'tileSize', type: 'vec2' },
- { name: 'layer', type: 'number', min: -1000, max: 1000 },
- ],
-};
-
-export const ToggleSchema: ComponentSchema = {
- name: 'Toggle',
- category: 'ui',
- properties: [
- { name: 'isOn', type: 'boolean' },
- { name: 'graphicEntity', type: 'entity' },
- { name: 'transition', type: 'button-transition' },
- ],
-};
-
-export const ToggleGroupSchema: ComponentSchema = {
- name: 'ToggleGroup',
- category: 'ui',
- properties: [
- { name: 'allowSwitchOff', type: 'boolean' },
- ],
-};
-
-export const ProgressBarSchema: ComponentSchema = {
- name: 'ProgressBar',
- category: 'ui',
- properties: [
- { name: 'value', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'fillEntity', type: 'entity' },
- {
- name: 'direction',
- type: 'enum',
- options: [
- { label: 'LeftToRight', value: 0 },
- { label: 'RightToLeft', value: 1 },
- { label: 'BottomToTop', value: 2 },
- { label: 'TopToBottom', value: 3 },
- ],
- },
- ],
-};
-
-export const DraggableSchema: ComponentSchema = {
- name: 'Draggable',
- category: 'ui',
- properties: [
- { name: 'enabled', type: 'boolean' },
- { name: 'dragThreshold', type: 'number', min: 0, step: 1 },
- { name: 'lockX', type: 'boolean' },
- { name: 'lockY', type: 'boolean' },
- ],
-};
-
-export const ScrollViewSchema: ComponentSchema = {
- name: 'ScrollView',
- category: 'ui',
- properties: [
- { name: 'contentEntity', type: 'entity' },
- { name: 'horizontalEnabled', type: 'boolean' },
- { name: 'verticalEnabled', type: 'boolean' },
- { name: 'contentWidth', type: 'number', min: 0, step: 1 },
- { name: 'contentHeight', type: 'number', min: 0, step: 1 },
- { name: 'inertia', type: 'boolean' },
- { name: 'decelerationRate', type: 'number', min: 0, max: 1, step: 0.01 },
- { name: 'elastic', type: 'boolean' },
- { name: 'wheelSensitivity', type: 'number', min: 0, max: 1, step: 0.01 },
- ],
-};
-
-export const SliderSchema: ComponentSchema = {
- name: 'Slider',
- category: 'ui',
- properties: [
- { name: 'value', type: 'number', step: 0.01 },
- { name: 'minValue', type: 'number', step: 0.01 },
- { name: 'maxValue', type: 'number', step: 0.01 },
- {
- name: 'direction',
- type: 'enum',
- options: [
- { label: 'LeftToRight', value: 0 },
- { label: 'RightToLeft', value: 1 },
- { label: 'BottomToTop', value: 2 },
- { label: 'TopToBottom', value: 3 },
- ],
- },
- { name: 'fillEntity', type: 'entity' },
- { name: 'handleEntity', type: 'entity' },
- { name: 'wholeNumbers', type: 'boolean' },
- ],
-};
-
-export const FocusableSchema: ComponentSchema = {
- name: 'Focusable',
- category: 'ui',
- properties: [
- { name: 'tabIndex', type: 'number', min: 0, step: 1 },
- ],
-};
-
-export const SafeAreaSchema: ComponentSchema = {
- name: 'SafeArea',
- category: 'ui',
- properties: [
- { name: 'applyTop', type: 'boolean' },
- { name: 'applyBottom', type: 'boolean' },
- { name: 'applyLeft', type: 'boolean' },
- { name: 'applyRight', type: 'boolean' },
- ],
-};
-
-export const ListViewSchema: ComponentSchema = {
- name: 'ListView',
- category: 'ui',
- properties: [
- { name: 'itemHeight', type: 'number', min: 1, step: 1 },
- { name: 'itemCount', type: 'number', min: 0, step: 1 },
- { name: 'overscan', type: 'number', min: 0, step: 1 },
- ],
-};
-
-export const DropdownSchema: ComponentSchema = {
- name: 'Dropdown',
- category: 'ui',
- properties: [
- { name: 'options', type: 'string-array' },
- { name: 'selectedIndex', type: 'number', min: -1, step: 1 },
- { name: 'listEntity', type: 'entity' },
- { name: 'labelEntity', type: 'entity' },
- ],
-};
-
-export const FlexContainerSchema: ComponentSchema = {
- name: 'FlexContainer',
- category: 'ui',
- properties: [
- {
- name: 'direction',
- type: 'enum',
- options: [
- { label: 'Row', value: 0 },
- { label: 'Column', value: 1 },
- { label: 'RowReverse', value: 2 },
- { label: 'ColumnReverse', value: 3 },
- ],
- },
- {
- name: 'wrap',
- type: 'enum',
- options: [
- { label: 'NoWrap', value: 0 },
- { label: 'Wrap', value: 1 },
- ],
- },
- {
- name: 'justifyContent',
- type: 'enum',
- options: [
- { label: 'Start', value: 0 },
- { label: 'Center', value: 1 },
- { label: 'End', value: 2 },
- { label: 'SpaceBetween', value: 3 },
- { label: 'SpaceAround', value: 4 },
- { label: 'SpaceEvenly', value: 5 },
- ],
- },
- {
- name: 'alignItems',
- type: 'enum',
- options: [
- { label: 'Start', value: 0 },
- { label: 'Center', value: 1 },
- { label: 'End', value: 2 },
- { label: 'Stretch', value: 3 },
- ],
- },
- { name: 'gap', type: 'vec2' },
- { name: 'padding', type: 'vec4' },
- ],
-};
-
-export const FlexItemSchema: ComponentSchema = {
- name: 'FlexItem',
- category: 'ui',
- properties: [
- { name: 'flexGrow', type: 'number', min: 0, step: 0.1 },
- { name: 'flexShrink', type: 'number', min: 0, step: 0.1 },
- { name: 'flexBasis', type: 'number', step: 1 },
- { name: 'order', type: 'number', step: 1 },
- ],
-};
-
-export const LayoutGroupSchema: ComponentSchema = {
- name: 'LayoutGroup',
- category: 'ui',
- properties: [
- {
- name: 'direction',
- type: 'enum',
- options: [
- { label: 'Horizontal', value: 0 },
- { label: 'Vertical', value: 1 },
- ],
- },
- { name: 'spacing', type: 'number', step: 1 },
- {
- name: 'childAlignment',
- type: 'enum',
- options: [
- { label: 'Start', value: 0 },
- { label: 'Center', value: 1 },
- { label: 'End', value: 2 },
- ],
- },
- { name: 'reverseOrder', type: 'boolean' },
- ],
-};
-
-export const ParticleEmitterSchema: ComponentSchema = {
- name: 'ParticleEmitter',
- category: 'builtin',
- properties: [
- { name: 'enabled', type: 'boolean' },
- { name: 'playOnStart', type: 'boolean' },
- { name: 'looping', type: 'boolean' },
- { name: 'duration', type: 'number', min: 0, step: 0.1 },
- { name: 'rate', type: 'number', min: 0, step: 1, group: 'Emission' },
- { name: 'burstCount', type: 'number', min: 0, step: 1, group: 'Emission' },
- { name: 'burstInterval', type: 'number', min: 0, step: 0.1, group: 'Emission' },
- { name: 'maxParticles', type: 'number', min: 1, step: 1, group: 'Emission' },
- { name: 'lifetimeMin', type: 'number', min: 0, step: 0.1, group: 'Lifetime' },
- { name: 'lifetimeMax', type: 'number', min: 0, step: 0.1, group: 'Lifetime' },
- {
- name: 'shape',
- type: 'enum',
- group: 'Shape',
- options: [
- { label: 'Point', value: 0 },
- { label: 'Circle', value: 1 },
- { label: 'Rectangle', value: 2 },
- { label: 'Cone', value: 3 },
- ],
- },
- { name: 'shapeRadius', type: 'number', min: 0, step: 0.1, group: 'Shape' },
- { name: 'shapeSize', type: 'vec2', group: 'Shape' },
- { name: 'shapeAngle', type: 'number', min: 0, max: 360, step: 1, group: 'Shape' },
- { name: 'speedMin', type: 'number', min: 0, step: 0.1, group: 'Velocity' },
- { name: 'speedMax', type: 'number', min: 0, step: 0.1, group: 'Velocity' },
- { name: 'angleSpreadMin', type: 'number', min: 0, max: 360, step: 1, group: 'Velocity' },
- { name: 'angleSpreadMax', type: 'number', min: 0, max: 360, step: 1, group: 'Velocity' },
- { name: 'startSizeMin', type: 'number', min: 0, step: 0.1, group: 'Size' },
- { name: 'startSizeMax', type: 'number', min: 0, step: 0.1, group: 'Size' },
- { name: 'endSizeMin', type: 'number', min: 0, step: 0.1, group: 'Size' },
- { name: 'endSizeMax', type: 'number', min: 0, step: 0.1, group: 'Size' },
- {
- name: 'sizeEasing',
- type: 'enum',
- group: 'Size',
- options: [
- { label: 'Linear', value: 0 },
- { label: 'EaseIn', value: 1 },
- { label: 'EaseOut', value: 2 },
- { label: 'EaseInOut', value: 3 },
- ],
- },
- { name: 'startColor', type: 'color', group: 'Color' },
- { name: 'endColor', type: 'color', group: 'Color' },
- {
- name: 'colorEasing',
- type: 'enum',
- group: 'Color',
- options: [
- { label: 'Linear', value: 0 },
- { label: 'EaseIn', value: 1 },
- { label: 'EaseOut', value: 2 },
- { label: 'EaseInOut', value: 3 },
- ],
- },
- { name: 'rotationMin', type: 'number', step: 1, group: 'Rotation' },
- { name: 'rotationMax', type: 'number', step: 1, group: 'Rotation' },
- { name: 'angularVelocityMin', type: 'number', step: 1, group: 'Rotation' },
- { name: 'angularVelocityMax', type: 'number', step: 1, group: 'Rotation' },
- { name: 'gravity', type: 'vec2', group: 'Forces' },
- { name: 'damping', type: 'number', min: 0, step: 0.01, group: 'Forces' },
- { name: 'texture', type: 'texture', group: 'Texture' },
- { name: 'spriteColumns', type: 'number', min: 1, step: 1, group: 'Texture' },
- { name: 'spriteRows', type: 'number', min: 1, step: 1, group: 'Texture' },
- { name: 'spriteFPS', type: 'number', min: 1, step: 1, group: 'Texture' },
- { name: 'spriteLoop', type: 'boolean', group: 'Texture' },
- {
- name: 'blendMode',
- type: 'enum',
- group: 'Rendering',
- options: [
- { label: 'Normal', value: 0 },
- { label: 'Additive', value: 1 },
- ],
- },
- { name: 'layer', type: 'number', min: -1000, max: 1000, group: 'Rendering' },
- { name: 'material', type: 'material-file', group: 'Rendering' },
- {
- name: 'simulationSpace',
- type: 'enum',
- group: 'Rendering',
- options: [
- { label: 'World', value: 0 },
- { label: 'Local', value: 1 },
- ],
- },
- ],
-};
-
-export const UIInteractionSchema: ComponentSchema = {
- name: 'UIInteraction',
- category: 'tag',
- removable: false,
- properties: [],
-};
-
-export const TilemapSchema: ComponentSchema = {
- name: 'Tilemap',
- category: 'builtin',
- properties: [
- { name: 'source', type: 'tilemap-file' },
- ],
-};
-
-export const TilemapLayerSchema: ComponentSchema = {
- name: 'TilemapLayer',
- category: 'builtin',
- hidden: true,
- properties: [
- { name: 'width', type: 'number', min: 1, max: 1000 },
- { name: 'height', type: 'number', min: 1, max: 1000 },
- { name: 'tileWidth', type: 'number', min: 1, max: 512 },
- { name: 'tileHeight', type: 'number', min: 1, max: 512 },
- { name: 'texture', type: 'number' },
- { name: 'tilesetColumns', type: 'number', min: 1, max: 256 },
- { name: 'layer', type: 'number', min: -1000, max: 1000 },
- ],
-};
-
// =============================================================================
// Registry
// =============================================================================
@@ -1003,100 +134,36 @@ function registerUserComponent(
schemaRegistry.set(name, schema);
}
-function exposeRegistrationAPI(): void {
+export function exposeRegistrationAPI(): void {
if (typeof window !== 'undefined') {
window.__esengine_registerComponent = registerUserComponent;
}
}
-export const TimelinePlayerSchema: ComponentSchema = {
- name: 'TimelinePlayer',
- category: 'builtin',
- properties: [
- { name: 'timeline', type: 'timeline-file' },
- { name: 'playing', type: 'boolean' },
- { name: 'speed', type: 'number', min: 0, max: 10, step: 0.1 },
- { name: 'wrapMode', type: 'enum', options: [
- { label: 'Once', value: 'once' },
- { label: 'Loop', value: 'loop' },
- { label: 'Ping Pong', value: 'pingPong' },
- ]},
- ],
-};
+// =============================================================================
+// Backward-compatible re-exports from plugins
+// =============================================================================
-export const PostProcessVolumeSchema: ComponentSchema = {
- name: 'PostProcessVolume',
- category: 'builtin',
- properties: [],
-};
+export { TransformSchema, CameraSchema } from '../plugins/coreComponents';
+export { SpriteSchema } from '../plugins/sprite';
+export { TextSchema } from '../plugins/text';
// =============================================================================
-// Initialization
+// Legacy registration (kept for backward compat)
// =============================================================================
export interface BuiltinSchemaOptions {
enableSpine?: boolean;
}
-export function registerBuiltinSchemas(options?: BuiltinSchemaOptions): void {
- const enableSpine = options?.enableSpine ?? true;
-
- registerComponentSchema(NameSchema);
- registerComponentSchema(ParentSchema);
- registerComponentSchema(ChildrenSchema);
- registerComponentSchema(TransformSchema);
- registerComponentSchema(SpriteSchema);
- registerComponentSchema(ShapeRendererSchema);
- registerComponentSchema(CameraSchema);
- registerComponentSchema(VelocitySchema);
- registerComponentSchema(SceneOwnerSchema);
- registerComponentSchema(TextSchema);
- registerComponentSchema(UIRectSchema);
- registerComponentSchema(CanvasSchema);
- registerComponentSchema(BitmapTextSchema);
- registerComponentSchema(UIMaskSchema);
- registerComponentSchema(InteractableSchema);
- registerComponentSchema(UIInteractionSchema);
- registerComponentSchema(ButtonSchema);
- registerComponentSchema(TextInputSchema);
- registerComponentSchema(ImageSchema);
- registerComponentSchema(ToggleSchema);
- registerComponentSchema(ToggleGroupSchema);
- registerComponentSchema(ProgressBarSchema);
- registerComponentSchema(DraggableSchema);
- registerComponentSchema(ScrollViewSchema);
- registerComponentSchema(SliderSchema);
- registerComponentSchema(FocusableSchema);
- registerComponentSchema(SafeAreaSchema);
- registerComponentSchema(ListViewSchema);
- registerComponentSchema(DropdownSchema);
- registerComponentSchema(FlexContainerSchema);
- registerComponentSchema(FlexItemSchema);
- registerComponentSchema(LayoutGroupSchema);
- registerComponentSchema(SpriteAnimatorSchema);
- registerComponentSchema(AudioSourceSchema);
- registerComponentSchema(AudioListenerSchema);
- registerComponentSchema(RigidBodySchema);
- registerComponentSchema(BoxColliderSchema);
- registerComponentSchema(CircleColliderSchema);
- registerComponentSchema(CapsuleColliderSchema);
- registerComponentSchema(SegmentColliderSchema);
- registerComponentSchema(PolygonColliderSchema);
- registerComponentSchema(ChainColliderSchema);
- registerComponentSchema(RevoluteJointSchema);
- registerComponentSchema(ParticleEmitterSchema);
- registerComponentSchema(TilemapSchema);
- registerComponentSchema(TilemapLayerSchema);
- registerComponentSchema(TimelinePlayerSchema);
- registerComponentSchema(PostProcessVolumeSchema);
- if (enableSpine) {
- registerComponentSchema(SpineAnimationSchema);
- }
+export function registerBuiltinSchemas(_options?: BuiltinSchemaOptions): void {
+ // Schemas are now registered via EditorPlugin system.
+ // This function is kept for backward compatibility.
exposeRegistrationAPI();
}
export function registerSpineSchema(): void {
- registerComponentSchema(SpineAnimationSchema);
+ // Spine schema is now registered via the spine plugin.
}
// =============================================================================
diff --git a/editor/src/schemas/schemaConstants.ts b/editor/src/schemas/schemaConstants.ts
new file mode 100644
index 000000000..9de9a0d30
--- /dev/null
+++ b/editor/src/schemas/schemaConstants.ts
@@ -0,0 +1,7 @@
+export const LAYER_MIN = -1000;
+export const LAYER_MAX = 1000;
+export const FONT_SIZE_MIN = 8;
+export const FONT_SIZE_MAX = 200;
+export const TIME_SCALE_MAX = 10;
+export const SKELETON_SCALE_MIN = 0.01;
+export const SKELETON_SCALE_MAX = 100;
diff --git a/editor/src/utils/sceneQueries.ts b/editor/src/utils/sceneQueries.ts
new file mode 100644
index 000000000..8db7ce227
--- /dev/null
+++ b/editor/src/utils/sceneQueries.ts
@@ -0,0 +1,23 @@
+import { DEFAULT_PIXELS_PER_UNIT } from 'esengine';
+import type { EntityDataLike } from '../math/Transform';
+
+export type SizeProvider = 'UIRect' | 'Sprite' | null;
+
+export function getSizeProvider(entity: EntityDataLike): SizeProvider {
+ if (entity.components.some(c => c.type === 'UIRect')) return 'UIRect';
+ if (entity.components.some(c => c.type === 'Sprite')) return 'Sprite';
+ return null;
+}
+
+export function findScenePixelsPerUnit(
+ entities: Iterable<EntityDataLike>,
+ defaultValue: number = DEFAULT_PIXELS_PER_UNIT,
+): number {
+ for (const entity of entities) {
+ const canvas = entity.components.find(c => c.type === 'Canvas');
+ if (canvas) {
+ return (canvas.data.pixelsPerUnit as number) || defaultValue;
+ }
+ }
+ return defaultValue;
+}