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.

feat(physics+editor): standalone physics in the editor, scale perf, subsystem observability

esengineeba32e17eb66
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 552145cfb..efc4b5781 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -543,6 +543,25 @@ html,body{width:100%;height:100%;overflow:hidden;background:#1a1a1a}
OUTPUT_NAME "physics"
RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/sdk"
)
+
+ # ESM variant (EXPORT_ES6=1) for the web editor's estella:// ESM host —
+ # imported like esengine.js. Same sources/wasm, no dynamic linking.
+ add_executable(physics_module_esm
+ src/esengine/bindings/PhysicsModuleEntry.cpp
+ src/esengine/bindings/PhysicsContext.cpp
+ src/esengine/bindings/PhysicsShapes.cpp
+ src/esengine/bindings/PhysicsJoints.cpp
+ src/esengine/bindings/PhysicsQueries.cpp
+ )
+ target_link_libraries(physics_module_esm PRIVATE box2d)
+ target_include_directories(physics_module_esm PRIVATE
+ ${CMAKE_CURRENT_SOURCE_DIR}/third_party/box2d/include
+ )
+ es_apply_physics_esm_module_settings(physics_module_esm)
+ set_target_properties(physics_module_esm PROPERTIES
+ OUTPUT_NAME "physics"
+ RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/sdk"
+ )
endif()
# Main module SDK (MAIN_MODULE=2, supports loading side modules)
diff --git a/build-tools/build.config.js b/build-tools/build.config.js
index af511daf9..9af4b43cb 100644
--- a/build-tools/build.config.js
+++ b/build-tools/build.config.js
@@ -48,7 +48,8 @@ export default {
physics: {
buildDir: 'build-physics',
cmakeFlags: ['-DES_BUILD_WEB=ON', '-DES_BUILD_TESTS=OFF', '-DES_ENABLE_BOX2D=ON'],
- targets: ['physics_module'],
+ // ESM variant (EXPORT_ES6=1) for the web editor — imported like esengine.js.
+ targets: ['physics_module_esm'],
outputs: {
'sdk/physics.js': 'wasm/web/physics.js',
'sdk/physics.wasm': 'wasm/web/physics.wasm',
diff --git a/build-tools/tasks/sync.js b/build-tools/tasks/sync.js
index 59fc6ceb1..121e533e7 100644
--- a/build-tools/tasks/sync.js
+++ b/build-tools/tasks/sync.js
@@ -1,6 +1,7 @@
import path from 'path';
-import { mkdir, cp, readdir, stat } from 'fs/promises';
+import { mkdir, cp, readdir, stat, readFile, writeFile } from 'fs/promises';
import { existsSync } from 'fs';
+import { execSync } from 'child_process';
import config from '../build.config.js';
import * as logger from '../utils/logger.js';
@@ -21,6 +22,9 @@ export async function syncToDesktop(options = {}) {
synced += await copyFiles(srcPath, destPath, ['.js', '.wasm']);
}
}
+ // Stamp a build manifest beside the wasm so the editor can detect
+ // variant / ABI drift and show build provenance (see desktop EngineGuard).
+ await writeWasmManifest(rootDir);
}
if (sdk) {
@@ -43,6 +47,53 @@ export async function syncToDesktop(options = {}) {
return { synced };
}
+// Write wasm.manifest.json into each wasm dest dir: the ABI hash the binary was
+// built against, the build variant(s) present, and git/time provenance. The
+// abiHash is read from the freshly-built SDK metadata — the wasm and that
+// constant are generated together by the EHT pipeline, so it faithfully mirrors
+// the binary's getAbiLayoutHash(). Defensive: a failure here only warns.
+async function writeWasmManifest(rootDir) {
+ try {
+ const variants = [...new Set(Object.keys(config.sync.wasm).map((src) => path.basename(src)))].filter(
+ (v) => existsSync(path.join(rootDir, 'build/wasm', v)),
+ );
+
+ const genPath = path.join(config.paths.sdk, 'src/component.generated.ts');
+ const gen = await readFile(genPath, 'utf8');
+ const m = /ABI_LAYOUT_HASH\s*=\s*['"]([0-9a-f]+)['"]/i.exec(gen);
+ const abiHash = m ? m[1] : 'unknown';
+
+ let gitSha = 'unknown';
+ try {
+ gitSha = execSync('git rev-parse --short HEAD', { cwd: rootDir }).toString().trim();
+ } catch {
+ // not a git checkout — leave 'unknown'
+ }
+
+ const manifest = {
+ schema: 1,
+ abiHash,
+ editorTarget: 'web',
+ variants,
+ gitSha,
+ builtAt: new Date().toISOString(),
+ };
+
+ const dests = [...new Set(Object.values(config.sync.wasm))];
+ for (const dest of dests) {
+ const destDir = path.join(rootDir, dest);
+ if (!existsSync(destDir)) continue;
+ await writeFile(
+ path.join(destDir, 'wasm.manifest.json'),
+ JSON.stringify(manifest, null, 2) + '\n',
+ );
+ }
+ logger.debug(`Stamped wasm.manifest.json (abi=${abiHash} git=${gitSha} variants=${variants.join(',') || 'none'})`);
+ } catch (err) {
+ logger.warn(`Could not stamp wasm.manifest.json: ${err.message}`);
+ }
+}
+
async function copyFiles(srcDir, destDir, extensions) {
if (!existsSync(srcDir)) {
return 0;
diff --git a/cmake/Emscripten.cmake b/cmake/Emscripten.cmake
index 268076d06..831966419 100644
--- a/cmake/Emscripten.cmake
+++ b/cmake/Emscripten.cmake
@@ -58,7 +58,9 @@ set(ES_EMSCRIPTEN_MAIN_MODULE_FLAGS
-sFORCE_FILESYSTEM=1
"-sEXPORT_NAME='ESEngineModule'"
"-sEXPORTED_FUNCTIONS=['_malloc','_free']"
- "-sEXPORTED_RUNTIME_METHODS=['ccall','cwrap','HEAPF32','HEAPU8','HEAPU32','FS','addFunction','loadDynamicLibrary']"
+ # 'GL' is required for the WebGL2 context binding (module.GL.registerContext);
+ # the monolithic web build exports it too — the main-module list had dropped it.
+ "-sEXPORTED_RUNTIME_METHODS=['ccall','cwrap','HEAPF32','HEAPU8','HEAPU32','GL','FS','addFunction','loadDynamicLibrary']"
-O3
-flto
-Wl,--gc-sections
@@ -368,8 +370,16 @@ set(ES_EMSCRIPTEN_PHYSICS_MODULE_FLAGS
-fno-exceptions
)
+# ESM variant of the standalone physics module — EXPORT_ES6=1 so the web editor
+# (estella:// ESM host) can `import()` it like esengine.js. Playable/wechat keep
+# the UMD variant (global ESPhysicsModule). Same standalone wasm, no dynamic link.
+set(ES_EMSCRIPTEN_PHYSICS_ESM_MODULE_FLAGS ${ES_EMSCRIPTEN_PHYSICS_MODULE_FLAGS})
+list(REMOVE_ITEM ES_EMSCRIPTEN_PHYSICS_ESM_MODULE_FLAGS -sEXPORT_ES6=0)
+list(APPEND ES_EMSCRIPTEN_PHYSICS_ESM_MODULE_FLAGS -sEXPORT_ES6=1 -sENVIRONMENT=web)
+
if(NOT BOX2D_DISABLE_SIMD)
list(APPEND ES_EMSCRIPTEN_PHYSICS_MODULE_FLAGS -msimd128)
+ list(APPEND ES_EMSCRIPTEN_PHYSICS_ESM_MODULE_FLAGS -msimd128)
list(APPEND ES_EMSCRIPTEN_PHYSICS_SIDE_MODULE_FLAGS -msimd128)
endif()
@@ -389,6 +399,23 @@ function(es_apply_physics_module_settings TARGET_NAME)
endif()
endfunction()
+# ESM variant settings (EXPORT_ES6=1) — see ES_EMSCRIPTEN_PHYSICS_ESM_MODULE_FLAGS.
+function(es_apply_physics_esm_module_settings TARGET_NAME)
+ if(ES_BUILD_WEB OR ES_BUILD_WXGAME)
+ set(_PHYSICS_COMPILE_FLAGS ${ES_EMSCRIPTEN_COMPILE_FLAGS} -flto -fno-rtti -fno-exceptions)
+ if(NOT BOX2D_DISABLE_SIMD)
+ list(APPEND _PHYSICS_COMPILE_FLAGS -msimd128)
+ endif()
+ target_compile_options(${TARGET_NAME} PRIVATE ${_PHYSICS_COMPILE_FLAGS})
+
+ string(REPLACE ";" " " LINK_FLAGS_STR "${ES_EMSCRIPTEN_PHYSICS_ESM_MODULE_FLAGS}")
+ set_target_properties(${TARGET_NAME} PROPERTIES
+ SUFFIX ".js"
+ LINK_FLAGS "${LINK_FLAGS_STR}"
+ )
+ endif()
+endfunction()
+
message(STATUS "Emscripten configuration loaded")
if(ES_BUILD_MAIN_MODULE)
message(STATUS "MAIN_MODULE build enabled: supports loading SIDE_MODULE")
diff --git a/desktop/electron/buildPlayRealm.ts b/desktop/electron/buildPlayRealm.ts
index eb0976d3f..b2d99e66e 100644
--- a/desktop/electron/buildPlayRealm.ts
+++ b/desktop/electron/buildPlayRealm.ts
@@ -15,7 +15,7 @@
* Pure Node (esbuild + fs); IPC wiring in main.ts.
*/
import { build } from 'esbuild';
-import { cp, mkdir, rm, writeFile, readFile, stat } from 'node:fs/promises';
+import { cp, mkdir, rm, writeFile, readFile, stat, readdir } from 'node:fs/promises';
import { existsSync } from 'node:fs';
import { createHash } from 'node:crypto';
import path from 'node:path';
@@ -74,10 +74,24 @@ export interface PlayRealmResult {
errors: string[];
}
-/** Copy `src`→`dst` only when `marker`'s mtime changed since the last copy. */
-async function syncDir(src: string, dst: string, marker: string, stampFile: string): Promise<void> {
+/** Signature over a dir's top-level entries (name+size+mtime) — catches an
+ * ADDED/removed file (e.g. physics.wasm), not just a changed marker file. */
+async function dirSignature(dir: string): Promise<string> {
+ const names = (await readdir(dir)).sort();
+ const parts: string[] = [];
+ for (const n of names) {
+ const s = await stat(path.join(dir, n));
+ parts.push(`${n}:${s.size}:${Math.round(s.mtimeMs)}`);
+ }
+ return parts.join('|');
+}
+
+/** Copy `src`→`dst` only when its dir signature changed since the last copy.
+ * Gating on a single marker missed files added later (physics.wasm) when the
+ * marker's mtime hadn't moved; a full signature re-copies on any add/remove. */
+async function syncDir(src: string, dst: string, stampFile: string): Promise<void> {
if (!existsSync(src)) return;
- const sig = String((await stat(marker)).mtimeMs);
+ const sig = await dirSignature(src);
if (existsSync(dst) && existsSync(stampFile) && (await readFile(stampFile, 'utf8')) === sig) return;
await rm(dst, { recursive: true, force: true });
await cp(src, dst, { recursive: true });
@@ -115,9 +129,9 @@ export async function buildPlayRealm(opts: {
return { ok: false, hostPath: '', errors };
}
- // 2. SDK + wasm copies (hash-gated on a marker file's mtime).
- await syncDir(opts.sdkDistDir, path.join(out, 'sdk'), path.join(opts.sdkDistDir, 'index.js'), path.join(out, '.sdk-stamp'));
- await syncDir(opts.wasmDir, path.join(out, 'wasm'), path.join(opts.wasmDir, 'esengine.js'), path.join(out, '.wasm-stamp'));
+ // 2. SDK + wasm copies (gated on a full dir signature, so an added file re-syncs).
+ await syncDir(opts.sdkDistDir, path.join(out, 'sdk'), path.join(out, '.sdk-stamp'));
+ await syncDir(opts.wasmDir, path.join(out, 'wasm'), path.join(out, '.wasm-stamp'));
// 3. Host page.
await writeFile(path.join(out, 'play.html'), PLAY_HTML);
diff --git a/desktop/src/engine/EditorControlSurface.ts b/desktop/src/engine/EditorControlSurface.ts
index f04c65d55..40082ad39 100644
--- a/desktop/src/engine/EditorControlSurface.ts
+++ b/desktop/src/engine/EditorControlSurface.ts
@@ -22,7 +22,7 @@ import type {
NodeKind,
SceneNode,
} from '@/types';
-import type { SceneData } from 'esengine';
+import type { SceneData, SubsystemStatus } from 'esengine';
import { EngineHost } from './EngineHost';
import type { SceneCommandsImpl } from './SceneCommands';
import type { SceneQueryImpl } from './SceneQuery';
@@ -190,6 +190,22 @@ export class EditorControlSurfaceImpl {
getStats(): { entities: number } {
return { entities: EngineHost.world?.getAllEntities().length ?? 0 };
}
+
+ /**
+ * The lifecycle + liveness of every engine subsystem (physics, audio, …) in
+ * this realm's engine — the "what's loaded and actually running" surface.
+ * Each entry carries phase (registered/initializing/ready/error) and derived
+ * activity (stepping/idle/inactive). The MCP server later marshals this same
+ * read over IPC; the editor UI reads it directly.
+ */
+ getSubsystems(): SubsystemStatus[] {
+ return EngineHost.getSubsystemsSnapshot();
+ }
+
+ /** Subscribe to subsystem status changes (phase transitions + sampled liveness). */
+ subscribeSubsystems(fn: () => void): () => void {
+ return EngineHost.subscribeSubsystems(fn);
+ }
}
// The app's default-session surface is `EditorSession.default.surface`, exported
diff --git a/desktop/src/engine/EngineHost.ts b/desktop/src/engine/EngineHost.ts
index 7abc99394..1d50fd8aa 100644
--- a/desktop/src/engine/EngineHost.ts
+++ b/desktop/src/engine/EngineHost.ts
@@ -13,7 +13,7 @@ import {
setEditorMode,
setPlayMode,
} from 'esengine';
-import type { App, ESEngineModule, ResourceDef } from 'esengine';
+import type { App, ESEngineModule, ResourceDef, SubsystemStatus } from 'esengine';
import { SceneLoader } from './SceneLoader';
import { checkEngineBuild } from './EngineGuard';
import type { ReadonlyWorldT, WorldT } from './schema';
@@ -48,6 +48,15 @@ class EngineHostImpl {
private readonly statusStore = createStore<EngineSnapshot>(() => ({ status: 'idle', error: null }));
+ // Subsystem (module) observability for the status bar: which engine modules
+ // are loaded, ready, stepping, or errored. Phase changes push immediately; a
+ // low-frequency sampler refreshes derived liveness (stepping↔idle) without
+ // per-frame churn. The signature gate keeps the snapshot reference stable
+ // (so useSyncExternalStore doesn't loop) while nothing actually changed.
+ private readonly subsystemStore = createStore<SubsystemStatus[]>(() => []);
+ private subsystemTimer: ReturnType<typeof setInterval> | null = null;
+ private subsystemSig = '';
+
// Play-state isolation: Stop rebuilds the World from the untouched edit model
// (model-authoritative), so no snapshot is needed — the model IS the truth.
private playing_ = false;
@@ -91,11 +100,31 @@ class EngineHostImpl {
subscribe = (fn: () => void): (() => void) => this.statusStore.subscribe(fn);
getSnapshot = (): EngineSnapshot => this.statusStore.getState();
+ // — Subsystem (module) status as an external store —
+ subscribeSubsystems = (fn: () => void): (() => void) => this.subsystemStore.subscribe(fn);
+ getSubsystemsSnapshot = (): SubsystemStatus[] => this.subsystemStore.getState();
+
private setStatus(status: EngineStatus, error: string | null = null) {
this.statusStore.setState({ status, error });
window.estella?.reportEngineStatus?.(error ? `${status}: ${error}` : status);
}
+ /**
+ * Pull the current subsystem statuses into the editor-facing store. Gated by a
+ * cheap signature so an unchanged sample neither swaps the snapshot reference
+ * nor re-renders subscribers. Wired to both the registry's transition events
+ * (immediate) and a low-frequency timer (derived liveness) in bootCore.
+ */
+ private syncSubsystems(app: App) {
+ const statuses = app.subsystems.getStatuses();
+ const sig = statuses
+ .map((s) => `${s.id}:${s.phase}:${s.activity}:${s.lastError ?? ''}`)
+ .join('|');
+ if (sig === this.subsystemSig) return;
+ this.subsystemSig = sig;
+ this.subsystemStore.setState(statuses, true);
+ }
+
private ensureCanvas(): HTMLCanvasElement {
if (!this.canvas_) {
const c = document.createElement('canvas');
@@ -338,6 +367,16 @@ class EngineHostImpl {
});
this.app_ = app;
+ // Subsystem observability: phase changes push immediately; the sampler
+ // refreshes derived liveness (stepping↔idle) a couple of times a second.
+ this.syncSubsystems(app);
+ app.subsystems.subscribe(() => this.syncSubsystems(app));
+ if (this.subsystemTimer == null) {
+ this.subsystemTimer = setInterval(() => {
+ if (this.app_) this.syncSubsystems(this.app_);
+ }, 500);
+ }
+
// Mark this an editor host and open in edit mode: gameplay systems
// (particle/animation/physics/timeline/…, gated on env.playModeOnly) are
// frozen so simulation doesn't fight edits, while render/transform/camera
diff --git a/desktop/src/engine/PlayInspect.ts b/desktop/src/engine/PlayInspect.ts
index ee667e6b8..93eacda89 100644
--- a/desktop/src/engine/PlayInspect.ts
+++ b/desktop/src/engine/PlayInspect.ts
@@ -15,14 +15,17 @@ import type { EntityId } from '@/types';
import { PlayRealm } from './PlayRealm';
interface PlayInspectState {
+ /** Shallow entity tree of the running World (Outliner). */
snapshot: SceneData | null;
+ /** Full data of the selected entity (Details), fetched alongside the tree. */
+ selectedEntity: SceneData['entities'][number] | null;
selection: EntityId | null;
}
const POLL_MS = 300;
class PlayInspectImpl {
- private readonly store = createStore<PlayInspectState>(() => ({ snapshot: null, selection: null }));
+ private readonly store = createStore<PlayInspectState>(() => ({ snapshot: null, selectedEntity: null, selection: null }));
private timer: ReturnType<typeof setInterval> | null = null;
subscribe = (fn: () => void): (() => void) => this.store.subscribe(fn);
@@ -30,6 +33,7 @@ class PlayInspectImpl {
select(selection: EntityId | null): void {
this.store.setState({ ...this.store.getState(), selection });
+ void this.poll(); // fetch the newly-selected entity's full data immediately
}
/** Begin polling the running realm (call on Play). */
@@ -45,7 +49,7 @@ class PlayInspectImpl {
clearInterval(this.timer);
this.timer = null;
}
- this.store.setState({ snapshot: null, selection: null });
+ this.store.setState({ snapshot: null, selectedEntity: null, selection: null });
}
/** Live-edit a field of the running game; refresh immediately for snappy feedback. */
@@ -55,8 +59,8 @@ class PlayInspectImpl {
}
private async poll(): Promise<void> {
- const snapshot = await PlayRealm.snapshot();
- if (snapshot) this.store.setState({ ...this.store.getState(), snapshot });
+ const res = await PlayRealm.snapshot(this.store.getState().selection);
+ if (res) this.store.setState({ ...this.store.getState(), snapshot: res.tree, selectedEntity: res.selected });
}
}
diff --git a/desktop/src/engine/PlayRealm.ts b/desktop/src/engine/PlayRealm.ts
index 9887514b9..61b2be71b 100644
--- a/desktop/src/engine/PlayRealm.ts
+++ b/desktop/src/engine/PlayRealm.ts
@@ -15,6 +15,9 @@ import type { SceneData } from 'esengine';
export interface PlayPayload {
sceneData: SceneData;
assetManifest: Record<string, string>;
+ /** Project-declared physics enable (features.physics) — forwarded to the realm. */
+ physicsEnabled?: boolean;
+ physicsGravity?: { x: number; y: number };
}
export interface PlayRealmSnapshot {
@@ -23,6 +26,13 @@ export interface PlayRealmSnapshot {
error: string | null;
}
+/** A live inspect snapshot: a shallow entity tree (Outliner) + the selected
+ * entity's full data (Details). See PlayRealm.snapshot. */
+export interface PlaySnapshot {
+ tree: SceneData;
+ selected: SceneData['entities'][number] | null;
+}
+
class PlayRealmImpl {
private iframe: HTMLIFrameElement | null = null;
private payload: PlayPayload | null = null;
@@ -92,14 +102,16 @@ class PlayRealmImpl {
private reqSeq = 0;
private readonly pending = new Map<number, (data: unknown) => void>();
- /** A live SceneData snapshot of the running game's World (null if not ready). */
- snapshot(): Promise<SceneData | null> {
+ /** A live inspect snapshot: a SHALLOW tree of the running World (cheap to ship
+ * even for thousands of entities) plus the FULL data of `selectedId` for the
+ * Details panel. Null if not ready. */
+ snapshot(selectedId: number | null): Promise<PlaySnapshot | null> {
if (!this.iframe?.contentWindow || !this.store.getState().ready) return Promise.resolve(null);
const reqId = ++this.reqSeq;
return new Promise((resolve) => {
- const done = (data: unknown) => resolve((data as SceneData) ?? null);
+ const done = (data: unknown) => resolve((data as PlaySnapshot) ?? null);
this.pending.set(reqId, done);
- this.post({ type: 'estella:play:query', kind: 'snapshot', reqId });
+ this.post({ type: 'estella:play:query', kind: 'snapshot', reqId, selectedId });
setTimeout(() => {
if (this.pending.delete(reqId)) resolve(null);
}, 2000);
diff --git a/desktop/src/gameHost.ts b/desktop/src/gameHost.ts
index c7c2ef659..eaba77018 100644
--- a/desktop/src/gameHost.ts
+++ b/desktop/src/gameHost.ts
@@ -71,7 +71,17 @@ async function boot(): Promise<void> {
});
setEditorMode(false);
setPlayMode(true);
- await initPlayRealmRuntime({ app, module, canvas, sceneData, assetManifest });
+ // physics.wasm sits next to esengine.wasm; the runtime loads it when the scene
+ // uses physics. (Runtime-spawned bodies still need a build-time enable flag —
+ // a follow-up that cooks features.physics into game.config.json.)
+ await initPlayRealmRuntime({
+ app,
+ module,
+ canvas,
+ sceneData,
+ assetManifest,
+ wasmBaseUrl: wasmBase.replace(/\/$/, ''),
+ });
}
boot().catch((err) => {
diff --git a/desktop/src/layout/StatusBar.tsx b/desktop/src/layout/StatusBar.tsx
index ae882068d..a4ed63e79 100644
--- a/desktop/src/layout/StatusBar.tsx
+++ b/desktop/src/layout/StatusBar.tsx
@@ -3,6 +3,7 @@ import { Gauge, MousePointer2, Boxes, FolderOpen } from 'lucide-react';
import { useEditorStore } from '@/store/editorStore';
import { useSelection } from '@/store/selectionStore';
import { StatsStore } from '@/engine/StatsStore';
+import { SubsystemIndicator } from './SubsystemIndicator';
// Bottom status strip — live engine telemetry (real FPS / entity count / cursor
// world position) reads in the mono face. Anchors the Content Drawer.
@@ -29,6 +30,7 @@ export function StatusBar() {
<span className={`sdot${isPlaying ? ' live' : ''}`} />
{isPlaying ? 'Running' : 'Edit Mode'}
</span>
+ <SubsystemIndicator />
<span className="sitem">
{selectedIds.size ? `${selectedIds.size} selected` : 'No selection'}
</span>
diff --git a/desktop/src/layout/SubsystemIndicator.tsx b/desktop/src/layout/SubsystemIndicator.tsx
new file mode 100644
index 000000000..e8a4e1484
--- /dev/null
+++ b/desktop/src/layout/SubsystemIndicator.tsx
@@ -0,0 +1,89 @@
+import { useSyncExternalStore, useState, useRef, useEffect } from 'react';
+import type { SubsystemStatus } from 'esengine';
+import { EngineHost } from '@/engine/EngineHost';
+
+// Status-bar indicator for engine subsystem (module) health. A single dot
+// summarizes the worst state; clicking opens a popover that lists each module
+// with its lifecycle phase and derived liveness. The data is the canonical
+// EditorControlSurface "observe" read, surfaced through EngineHost's store.
+
+type DotKind = 'ok' | 'idle' | 'busy' | 'err';
+
+/** Map a subsystem's phase + derived activity to a dot kind and a short label. */
+function present(s: SubsystemStatus): { dot: DotKind; text: string; run?: boolean } {
+ if (s.phase === 'error') return { dot: 'err', text: 'error' };
+ if (s.phase === 'initializing') return { dot: 'busy', text: 'loading…' };
+ if (s.phase === 'registered') return { dot: 'busy', text: 'registered' };
+ // ready: distinguish actively stepping vs frozen vs never-probed
+ if (s.activity === 'stepping') return { dot: 'ok', text: 'running', run: true };
+ if (s.activity === 'idle') return { dot: 'idle', text: 'idle' };
+ return { dot: 'ok', text: 'ready' };
+}
+
+/** Worst-of summary for the trigger dot: error ▸ busy ▸ ok. */
+function overall(list: SubsystemStatus[]): DotKind {
+ if (list.some((s) => s.phase === 'error')) return 'err';
+ if (list.some((s) => s.phase === 'initializing' || s.phase === 'registered')) return 'busy';
+ return 'ok';
+}
+
+export function SubsystemIndicator() {
+ const subsystems = useSyncExternalStore(
+ EngineHost.subscribeSubsystems,
+ EngineHost.getSubsystemsSnapshot,
+ );
+ const [open, setOpen] = useState(false);
+ const wrapRef = useRef<HTMLDivElement>(null);
+
+ // Dismiss on outside click while open.
+ useEffect(() => {
+ if (!open) return;
+ const onDown = (e: MouseEvent) => {
+ if (wrapRef.current && !wrapRef.current.contains(e.target as Node)) setOpen(false);
+ };
+ window.addEventListener('mousedown', onDown);
+ return () => window.removeEventListener('mousedown', onDown);
+ }, [open]);
+
+ const dot = overall(subsystems);
+
+ return (
+ <div className="mods-wrap" ref={wrapRef}>
+ <button
+ type="button"
+ className="sitem click"
+ title="Engine modules"
+ onClick={() => setOpen((v) => !v)}
+ >
+ <span className={`mdot ${dot}`} />
+ Modules
+ </button>
+ {open && (
+ <div className="mods-pop" role="menu">
+ <h4>Engine Modules</h4>
+ {subsystems.length === 0 ? (
+ <div className="mods-empty">Engine not booted</div>
+ ) : (
+ subsystems.map((s) => {
+ const p = present(s);
+ return (
+ <div key={s.id} className="mods-block">
+ <div className="mods-row">
+ <span className={`mdot ${p.dot}`} />
+ <span className="mn">{s.displayName}</span>
+ <span className={`ms${p.dot === 'err' ? ' err' : p.run ? ' run' : ''}`}>
+ {p.text}
+ </span>
+ </div>
+ {s.phase === 'error' && s.lastError && (
+ <div className="mods-err">{s.lastError}</div>
+ )}
+ </div>
+ );
+ })
+ )}
+ </div>
+ )}
+ </div>
+ );
+}
diff --git a/desktop/src/panels/Details.tsx b/desktop/src/panels/Details.tsx
index 721fb79e6..b773ac3ae 100644
--- a/desktop/src/panels/Details.tsx
+++ b/desktop/src/panels/Details.tsx
@@ -32,6 +32,7 @@ import { SceneQuery, buildEntityInfo, buildInspector } from '@/engine/SceneQuery
import { SceneModel } from '@/engine/SceneModel';
import { SceneCommands, toModelValue } from '@/engine/SceneCommands';
import { PlayInspect } from '@/engine/PlayInspect';
+import type { SceneData } from 'esengine';
import { modelAddableComponentEntries } from '@/engine/schema';
import { ProjectStore } from '@/project/ProjectStore';
import { ContextMenu } from '@/components/Menu';
@@ -472,7 +473,7 @@ function ComponentSection({
// routes edits to the realm (live, reverts on Stop). Structure is read-only here
// (no add/remove/rename of the running game) — just live value debugging.
function GameDetails() {
- const { snapshot, selection } = useSyncExternalStore(PlayInspect.subscribe, PlayInspect.getSnapshot);
+ const { selectedEntity, selection } = useSyncExternalStore(PlayInspect.subscribe, PlayInspect.getSnapshot);
const [collapsed, setCollapsed] = useState<Set<string>>(new Set());
const toggle = (name: string) =>
setCollapsed((s) => {
@@ -482,10 +483,14 @@ function GameDetails() {
return n;
});
- const info = selection != null ? buildEntityInfo(snapshot, selection) : null;
- const inspector = selection != null ? buildInspector(snapshot, selection) : [];
+ // The shallow tree snapshot strips component data; Details reads the selected
+ // entity's FULL data, fetched alongside the tree. Wrap it as a one-entity
+ // SceneData so the shared view-model builders apply unchanged.
+ const selData = selectedEntity ? ({ entities: [selectedEntity] } as SceneData) : null;
+ const info = selection != null ? buildEntityInfo(selData, selection) : null;
+ const inspector = selection != null ? buildInspector(selData, selection) : [];
const compData = (name: string): Record<string, unknown> =>
- (snapshot?.entities.find((e) => e.id === selection)?.components.find((c) => c.type === name)?.data as Record<string, unknown>) ?? {};
+ (selectedEntity?.components.find((c) => c.type === name)?.data as Record<string, unknown>) ?? {};
return (
<div className="insp">
diff --git a/desktop/src/panels/Outliner.tsx b/desktop/src/panels/Outliner.tsx
index a599076bb..a7d72ee14 100644
--- a/desktop/src/panels/Outliner.tsx
+++ b/desktop/src/panels/Outliner.tsx
@@ -164,48 +164,87 @@ function flatVisible(nodes: SceneNode[], expanded: Set<EntityId>, forceExpand: b
}
}
-// The live "Game" tree (UE5 PIE world): a read-only view of the running realm's
-// entities (from PlayInspect's snapshot); click selects into PlayInspect, which
-// the Details panel inspects/edits live. Always-expanded (transient debug view).
-function GameRow({ node, depth, selection }: { node: SceneNode; depth: number; selection: EntityId | null }) {
+// One row of the live "Game" tree (UE5 PIE world): a read-only view of a running
+// realm entity; click selects into PlayInspect, which Details inspects/edits live.
+const GAME_ROW_H = 24; // must match .row height in outliner.css
+
+function GameRowFlat({ node, depth, selection }: { node: SceneNode; depth: number; selection: EntityId | null }) {
return (
- <>
- <div
- className={`row${selection === node.id ? ' sel' : ''}`}
- style={{ paddingLeft: depth * 14 }}
- onClick={() => PlayInspect.select(node.id)}
- >
- <span className="twist leaf">
- <ChevronRight size={9} strokeWidth={3} />
- </span>
- <span className="ricon">
- <NodeIcon kind={node.kind} />
- </span>
- <span className="rname">{node.name}</span>
- <span className="rtype">{KIND_TYPE[node.kind] ?? 'Entity'}</span>
- </div>
- {node.children?.map((c) => <GameRow key={c.id} node={c} depth={depth + 1} selection={selection} />)}
- </>
+ <div
+ className={`row${selection === node.id ? ' sel' : ''}`}
+ style={{ paddingLeft: depth * 14, height: GAME_ROW_H }}
+ onClick={() => PlayInspect.select(node.id)}
+ >
+ <span className="twist leaf">
+ <ChevronRight size={9} strokeWidth={3} />
+ </span>
+ <span className="ricon">
+ <NodeIcon kind={node.kind} />
+ </span>
+ <span className="rname">{node.name}</span>
+ <span className="rtype">{KIND_TYPE[node.kind] ?? 'Entity'}</span>
+ </div>
);
}
+// Virtualized: a stress scene can hold thousands of live entities, and the
+// snapshot refreshes a few times a second — rendering every row as a DOM node
+// would peg the editor's main thread. Flatten to render order (the game view is
+// always-expanded) and render only the rows in the scroll window.
function GameTree() {
const { snapshot, selection } = useSyncExternalStore(PlayInspect.subscribe, PlayInspect.getSnapshot);
const tree = useMemo(() => buildSceneTree(snapshot), [snapshot]);
- if (tree.length === 0) {
+ const flat = useMemo(() => {
+ const out: { node: SceneNode; depth: number }[] = [];
+ const walk = (nodes: SceneNode[], depth: number): void => {
+ for (const n of nodes) {
+ out.push({ node: n, depth });
+ if (n.children?.length) walk(n.children, depth + 1);
+ }
+ };
+ walk(tree, 0);
+ return out;
+ }, [tree]);
+
+ const scrollRef = useRef<HTMLDivElement>(null);
+ const [scrollTop, setScrollTop] = useState(0);
+ const [viewH, setViewH] = useState(600);
+ useEffect(() => {
+ const el = scrollRef.current;
+ if (!el) return;
+ const update = () => setViewH(el.clientHeight);
+ update();
+ const ro = new ResizeObserver(update);
+ ro.observe(el);
+ return () => ro.disconnect();
+ }, []);
+
+ if (flat.length === 0) {
return (
- <div className="empty">
- <Search size={22} strokeWidth={1.4} />
- <p>Waiting for the running game…</p>
+ <div className="pbody">
+ <div className="empty">
+ <Search size={22} strokeWidth={1.4} />
+ <p>Waiting for the running game…</p>
+ </div>
</div>
);
}
+
+ const OVERSCAN = 8;
+ const total = flat.length;
+ const start = Math.max(0, Math.floor(scrollTop / GAME_ROW_H) - OVERSCAN);
+ const end = Math.min(total, Math.ceil((scrollTop + viewH) / GAME_ROW_H) + OVERSCAN);
+
return (
- <>
- {tree.map((n) => (
- <GameRow key={n.id} node={n} depth={0} selection={selection} />
- ))}
- </>
+ <div ref={scrollRef} className="pbody" onScroll={(e) => setScrollTop(e.currentTarget.scrollTop)}>
+ <div style={{ height: total * GAME_ROW_H, position: 'relative' }}>
+ {flat.slice(start, end).map(({ node, depth }, i) => (
+ <div key={node.id} style={{ position: 'absolute', top: (start + i) * GAME_ROW_H, left: 0, right: 0 }}>
+ <GameRowFlat node={node} depth={depth} selection={selection} />
+ </div>
+ ))}
+ </div>
+ </div>
);
}
@@ -380,9 +419,7 @@ export function Outliner() {
</div>
)}
{gameMode ? (
- <div className="pbody">
- <GameTree />
- </div>
+ <GameTree />
) : (
<>
<div className="phead">
diff --git a/desktop/src/playHost.ts b/desktop/src/playHost.ts
index 1fa946f24..38992d703 100644
--- a/desktop/src/playHost.ts
+++ b/desktop/src/playHost.ts
@@ -19,6 +19,8 @@ interface InitMessage {
type: 'estella:play:init';
sceneData: SceneData;
assetManifest: Record<string, string>;
+ physicsEnabled?: boolean;
+ physicsGravity?: { x: number; y: number };
}
const canvas = document.getElementById('canvas') as HTMLCanvasElement;
@@ -84,6 +86,11 @@ async function boot(msg: InitMessage): Promise<void> {
canvas,
sceneData: msg.sceneData,
assetManifest: msg.assetManifest,
+ // physics.wasm is served next to esengine.wasm; load it on demand.
+ wasmBaseUrl: wasmBase.replace(/\/$/, ''),
+ physicsEnabled: msg.physicsEnabled,
+ physicsGravity: msg.physicsGravity,
+ enableStats: true, // editor profiler: per-phase / per-system frame timing
});
post({ type: 'estella:play:ready' });
} catch (err) {
@@ -121,7 +128,7 @@ function setField(entityId: number, comp: string, key: string, value: unknown):
}
window.addEventListener('message', (e: MessageEvent) => {
- const data = e.data as { type?: string; paused?: boolean; reqId?: number; kind?: string; entityId?: number; comp?: string; key?: string; value?: unknown } | null;
+ const data = e.data as { type?: string; paused?: boolean; reqId?: number; kind?: string; entityId?: number; comp?: string; key?: string; value?: unknown; selectedId?: number } | null;
if (!data || typeof data !== 'object') return;
switch (data.type) {
case 'estella:play:init':
@@ -133,8 +140,33 @@ window.addEventListener('message', (e: MessageEvent) => {
case 'estella:play:query':
// Live introspection for the editor's "Game" inspect mode (UE5 PIE Details).
if (data.kind === 'snapshot') {
- const snapshot = app ? serializeScene(app.world) : null;
- post({ type: 'estella:play:reply', reqId: data.reqId, data: snapshot });
+ // Live inspect: send a SHALLOW tree (the Outliner only needs component
+ // TYPES + name + each component's `enabled` flag — see modelKindOf/NameOf/
+ // IsVisible), not every component's data for thousands of entities. The
+ // selected entity's FULL data is sent alongside for the Details panel.
+ const full = app ? serializeScene(app.world) : null;
+ let reply: unknown = null;
+ if (full) {
+ const selId = data.selectedId;
+ const selected = selId != null ? (full.entities.find((en) => en.id === selId) ?? null) : null;
+ const tree = {
+ ...full,
+ entities: full.entities.map((en) => ({
+ ...en,
+ components: en.components.map((c) => {
+ const d = c.data as Record<string, unknown> | undefined;
+ return { type: c.type, data: d && 'enabled' in d ? { enabled: d.enabled } : {} };
+ }),
+ })),
+ };
+ reply = { tree, selected };
+ }
+ post({ type: 'estella:play:reply', reqId: data.reqId, data: reply });
+ } else if (data.kind === 'stats') {
+ // Per-phase + per-system frame timing for the editor profiler panel.
+ const phases = app ? Object.fromEntries(app.getPhaseTimings() ?? []) : {};
+ const systems = app ? Object.fromEntries(app.getSystemTimings() ?? []) : {};
+ post({ type: 'estella:play:reply', reqId: data.reqId, data: { phases, systems } });
}
break;
case 'estella:play:setField':
diff --git a/desktop/src/project/ProjectStore.ts b/desktop/src/project/ProjectStore.ts
index e62ecb475..0c5c808ba 100644
--- a/desktop/src/project/ProjectStore.ts
+++ b/desktop/src/project/ProjectStore.ts
@@ -10,7 +10,7 @@ import { SceneCommands } from '@/engine/SceneCommands';
import { setUserSchemas, userSchema, type UserComponentSchema } from '@/engine/schema';
import { useSelection } from '@/store/selectionStore';
import { Toasts } from '@/store/Toasts';
-import { resolveLayout, WORKSPACE_DIR, type OpenedProject, type ProjectLayout, type WorkspaceState } from './format';
+import { resolveLayout, WORKSPACE_DIR, PROJECT_MANIFEST_FILE, type OpenedProject, type ProjectFeatures, type ProjectLayout, type WorkspaceState } from './format';
/**
* Editor-side project/workspace model (RC12 §E7-3 / §E6-1).
@@ -42,6 +42,8 @@ interface ProjectState {
workspace: WorkspaceState;
/** Entry scene from the manifest (project-relative); the editor opens it. */
defaultScene?: string;
+ /** Engine features (subsystems) the project enables; drives the play realm. */
+ features?: ProjectFeatures;
/** The scene currently loaded into the world (project-relative path). */
currentScene: string | null;
}
@@ -167,6 +169,7 @@ class ProjectStoreImpl {
layout: resolveLayout(opened.manifest),
workspace: opened.workspace,
defaultScene: opened.manifest.defaultScene,
+ features: opened.manifest.features,
currentScene: null,
},
});
@@ -391,14 +394,51 @@ class ProjectStoreImpl {
* the lossless refs, not resolved handles — plus a uuid→url manifest the realm
* fetches over `estella://`. Null if no scene is loaded.
*/
- playPayload(): { sceneData: SceneData; assetManifest: Record<string, string> } | null {
+ playPayload(): {
+ sceneData: SceneData;
+ assetManifest: Record<string, string>;
+ physicsEnabled?: boolean;
+ physicsGravity?: { x: number; y: number };
+ } | null {
const sceneData = SceneModel.serialize();
if (!sceneData) return null;
// The realm runs from the project's estella:// origin, so assets are
// same-origin estella:// — no cross-scheme dance needed.
const assetManifest: Record<string, string> = {};
for (const [uuid, path] of this.uuidToPath) assetManifest[uuid] = `estella://project/${path}`;
- return { sceneData, assetManifest };
+ // Carry the project's declared physics enable so the realm installs physics
+ // even for runtime-spawned bodies the static scene doesn't show.
+ const physics = this.state?.features?.physics;
+ return { sceneData, assetManifest, physicsEnabled: physics?.enabled, physicsGravity: physics?.gravity };
+ }
+
+ /** The project's declared physics feature, with defaults (for Project Settings). */
+ physicsFeature(): { enabled: boolean; gravity: { x: number; y: number } } {
+ const p = this.state?.features?.physics;
+ return { enabled: p?.enabled ?? false, gravity: p?.gravity ?? { x: 0, y: -9.81 } };
+ }
+
+ /**
+ * Enable/configure the project's physics feature and persist to
+ * `project.esproject` (so the play realm installs physics even for
+ * runtime-spawned bodies). Rewrites the RAW manifest JSON so fields the editor
+ * parser doesn't model survive; in-memory state updates first so the toggle
+ * reflects immediately.
+ */
+ async setPhysics(patch: { enabled?: boolean; gravity?: { x: number; y: number } }): Promise<void> {
+ const st = this.state;
+ if (!st) return;
+ const physics: NonNullable<ProjectFeatures['physics']> = { ...st.features?.physics, ...patch };
+ const features: ProjectFeatures = { ...st.features, physics };
+ this.store.setState({ project: { ...st, features } });
+ try {
+ const raw = JSON.parse(await window.estella.fs.read(PROJECT_MANIFEST_FILE)) as Record<string, unknown>;
+ raw.features = { ...(raw.features as Record<string, unknown> ?? {}), physics };
+ await window.estella.fs.write(PROJECT_MANIFEST_FILE, JSON.stringify(raw, null, 2) + '\n');
+ } catch (e) {
+ Toasts.push('Failed to save physics setting', 'error');
+ console.error('[project] setPhysics write failed', e);
+ }
}
/** Display info for an asset ref (`@uuid:`), or null (none / unresolved). For
diff --git a/desktop/src/project/format.ts b/desktop/src/project/format.ts
index de54e1c4b..a13810174 100644
--- a/desktop/src/project/format.ts
+++ b/desktop/src/project/format.ts
@@ -54,6 +54,20 @@ export interface ProjectScripts {
main?: string;
}
+/**
+ * Engine features (subsystems) the project enables — the UE5 `.uproject`
+ * "Plugins" analog. Declaring physics here installs it in the play realm /
+ * exported game even when the static scene carries no bodies (e.g. a project
+ * that spawns RigidBodies from a script at runtime). Absence ⇒ off; physics also
+ * auto-installs when a scene actually uses physics components.
+ */
+export interface ProjectFeatures {
+ physics?: {
+ enabled?: boolean;
+ gravity?: { x: number; y: number };
+ };
+}
+
/** Committed project identity + config (`project.esproject`). */
export interface ProjectManifest {
/** Manifest schema version (migration-aware; rejects newer than supported). */
@@ -77,6 +91,8 @@ export interface ProjectManifest {
description?: string;
/** Short category label for the template gallery (e.g. "2D", "Physics"). */
tag?: string;
+ /** Engine features (subsystems) the project enables; see {@link ProjectFeatures}. */
+ features?: ProjectFeatures;
}
/** A New-project template (a project directory used as a starting point). */
@@ -159,6 +175,21 @@ export function parseManifest(raw: unknown): ProjectManifest {
}
if (typeof o.description === 'string') manifest.description = o.description;
if (typeof o.tag === 'string') manifest.tag = o.tag;
+ if (o.features && typeof o.features === 'object') {
+ const f = o.features as Record<string, unknown>;
+ const features: ProjectFeatures = {};
+ if (f.physics && typeof f.physics === 'object') {
+ const p = f.physics as Record<string, unknown>;
+ const physics: NonNullable<ProjectFeatures['physics']> = {};
+ if (typeof p.enabled === 'boolean') physics.enabled = p.enabled;
+ const g = p.gravity as { x?: unknown; y?: unknown } | undefined;
+ if (g && typeof g.x === 'number' && typeof g.y === 'number') {
+ physics.gravity = { x: g.x, y: g.y };
+ }
+ features.physics = physics;
+ }
+ if (Object.keys(features).length > 0) manifest.features = features;
+ }
return manifest;
}
diff --git a/desktop/src/settings/index.ts b/desktop/src/settings/index.ts
index 3ea1b5ab9..01bb206a8 100644
--- a/desktop/src/settings/index.ts
+++ b/desktop/src/settings/index.ts
@@ -3,6 +3,7 @@
* settings (./editorSettings side effect) and exposes the registry + types.
*/
import './editorSettings';
+import './projectSettings';
export { settingsRegistry } from './registry';
export type {
diff --git a/desktop/src/settings/projectSettings.ts b/desktop/src/settings/projectSettings.ts
new file mode 100644
index 000000000..1064ee166
--- /dev/null
+++ b/desktop/src/settings/projectSettings.ts
@@ -0,0 +1,58 @@
+/**
+ * @file projectSettings.ts — project-scoped settings, persisted to
+ * project.esproject (the editorSettings.ts extension point for project/
+ * plugin sections). Registered as a side effect; SettingsDialog renders
+ * them under the "Project" category with no UI change. Bound to
+ * ProjectStore, which owns manifest read/write.
+ */
+import { settingsRegistry } from './registry';
+import { ProjectStore } from '@/project/ProjectStore';
+
+// ── Physics (the enable flag = UE Plugins-Browser analog; gravity = Project Settings) ──
+settingsRegistry.registerSection({ id: 'physics', label: 'Physics', category: 'project', order: 1 });
+
+settingsRegistry.register({
+ id: 'project.physics.enabled',
+ type: 'boolean',
+ scope: 'project',
+ section: 'physics',
+ group: 'Physics',
+ label: 'Enable physics',
+ description: 'Install the Box2D world when this project plays — required for bodies a script spawns at runtime.',
+ default: false,
+ bind: {
+ get: () => ProjectStore.physicsFeature().enabled,
+ set: (v) => void ProjectStore.setPhysics({ enabled: v }),
+ },
+});
+
+settingsRegistry.register({
+ id: 'project.physics.gravityX',
+ type: 'number',
+ scope: 'project',
+ section: 'physics',
+ group: 'Gravity',
+ label: 'Gravity X',
+ default: 0,
+ step: 0.1,
+ bind: {
+ get: () => ProjectStore.physicsFeature().gravity.x,
+ set: (v) => void ProjectStore.setPhysics({ gravity: { ...ProjectStore.physicsFeature().gravity, x: v } }),
+ },
+});
+
+settingsRegistry.register({
+ id: 'project.physics.gravityY',
+ type: 'number',
+ scope: 'project',
+ section: 'physics',
+ group: 'Gravity',
+ label: 'Gravity Y',
+ description: 'Negative pulls down (Box2D default −9.81).',
+ default: -9.81,
+ step: 0.1,
+ bind: {
+ get: () => ProjectStore.physicsFeature().gravity.y,
+ set: (v) => void ProjectStore.setPhysics({ gravity: { ...ProjectStore.physicsFeature().gravity, y: v } }),
+ },
+});
diff --git a/desktop/src/theme/chrome.css b/desktop/src/theme/chrome.css
index 78b731944..80657fda4 100644
--- a/desktop/src/theme/chrome.css
+++ b/desktop/src/theme/chrome.css
@@ -149,6 +149,49 @@
.cb-btn:hover { color: var(--text); background: var(--srf-3); }
.cb-btn.active { color: #fff; background: var(--acc); }
+/* ── Engine modules indicator + popover ── */
+.mdot { width: 7px; height: 7px; border-radius: 50%; background: var(--text-mute); flex-shrink: 0; }
+.mdot.ok { background: var(--run-hi); }
+.mdot.idle { background: transparent; box-shadow: inset 0 0 0 1.5px var(--text-mute); }
+.mdot.busy { background: var(--warn); }
+.mdot.err { background: var(--error); }
+.mods-wrap { position: relative; display: inline-flex; }
+.mods-pop {
+ position: absolute;
+ bottom: calc(100% + 6px);
+ left: 0;
+ min-width: 248px;
+ background: var(--srf-2);
+ border: 1px solid var(--border);
+ border-radius: var(--r-sm);
+ box-shadow: var(--shadow-1);
+ padding: 6px;
+ z-index: 200;
+}
+.mods-pop h4 {
+ margin: 2px 6px 6px;
+ font-size: var(--fs-2xs);
+ text-transform: uppercase;
+ letter-spacing: .5px;
+ color: var(--text-mute);
+ font-weight: 600;
+}
+.mods-row {
+ display: flex;
+ align-items: center;
+ gap: 8px;
+ height: 26px;
+ padding: 0 6px;
+ border-radius: var(--r-sm);
+}
+.mods-row:hover { background: var(--srf-3); }
+.mods-row .mn { flex: 1; color: var(--text); font-size: var(--fs-sm); }
+.mods-row .ms { color: var(--text-mute); font-size: var(--fs-xs); font-family: var(--mono); }
+.mods-row .ms.run { color: var(--run-hi); }
+.mods-row .ms.err { color: var(--error); }
+.mods-err { padding: 0 6px 4px 22px; color: var(--error); font-size: var(--fs-2xs); font-family: var(--mono); word-break: break-word; }
+.mods-empty { padding: 12px 8px; color: var(--text-mute); font-size: var(--fs-xs); text-align: center; }
+
/* ── Activity bar (far-left icon rail) ── */
.activity {
width: var(--w-activity);
diff --git a/docs/RC12_EDITOR_SEAM.md b/docs/RC12_EDITOR_SEAM.md
new file mode 100644
index 000000000..29007a779
--- /dev/null
+++ b/docs/RC12_EDITOR_SEAM.md
@@ -0,0 +1,307 @@
+# RC12:编辑器接缝现代化(Editor Seam Re-architecture)
+
+> 目标读者:引擎维护者 / 编辑器作者 / AI 协作代理。
+> 本文是 `REARCH_FRONTIER.md`(RC7–RC11)的**姊妹篇**,体例一致:描述目标架构与根治路径,而非现状。
+> 现状审计见各小节"病灶"引用的 `file:line`(2026-06 只读审计,覆盖 `desktop/src/engine/*` 与 `sdk/src` 耦合面)。
+>
+> **立项缘由**:RC10(编辑器↔运行时协议)写于"**编辑器源码在仓外**"的假设下(见 `REARCH_FRONTIER.md` RC10 注)。该假设已失效——编辑器现作为 pnpm workspace 包 `@estella/editor` 落在 `desktop/`,通过 `workspace:*` 依赖 `esengine` SDK。接缝进仓后,RC10 的抽象债**具体化**为下列可直接动手的条目;其中 **E3/E5 是 RC10 的具体化**,**E6 是 RC9-1 的下游受害者**。本文不重复 RC7/RC8 的引擎内部现代化(渲染后端、并行、SIMD)——那些判断("WebGPU 性感但不插队")维持不变。
+
+---
+
+## 0. 核心诊断:一条接缝,两侧各自演化
+
+编辑器与引擎现在同处一个 JS realm、同一个进程,靠**直接 mutate 共享单例 World + 观察者回调**接通。这在"单机本地编辑器"语境下是正确的起点——不该为了协议洁癖去上 `postMessage`/RPC。但接缝当前的形态有三个结构性弱点,会在"加载真实项目"这一步同时引爆:
+
+1. **接缝两端的引擎产物各自漂移**:编辑器编译期链接 TS SDK、运行期加载 wasm,二者无构建期绑定(E1)。
+2. **接缝没有强制的写边界**:World 是事实全局,写路径靠约定收口而非结构强制,可静默绕过 undo(E2)。
+3. **接缝传递的信息过粗**:变更事件丢弃 payload,退化为"伪轮询"(E3)。
+
+放大器:**编辑器 mutate 的是一个每帧仍在 tick 系统的活动 World**(无 edit/play 模式,E4)。今天没炸,仅因 `SceneLoader` 把项目用户系统全 SKIP 了——而那恰恰也是"无损保存"做不了的同一个根因(E6)。
+
+> **亮点(不动)**:接缝的**分层切分本身是干净的**——`desktop/src/engine/` 已拆成 7 个聚焦模块(EngineHost 运行时 / SceneQuery 读 / SceneCommands 写 / ViewportController 拾取 / SceneStore 响应式 / EditorHistory 撤销 / schema 共享),依赖图无环。EngineHost 单 detached canvas 跨 dockview 重挂活下来、HMR self-reload 规避栈叠加 context(`EngineHost.ts:258-260`)也处理得当。本文的债集中在**模块之间那条线的契约**,不是模块划分。
+
+---
+
+## E1:两份引擎产物,无构建期版本/变体绑定
+
+### 病灶
+- **编辑器同时依赖引擎的两个独立产物**,二者只在"全量构建时恰好一起被拷贝"才一致:
+ 1. **TS SDK**:`esengine`(`desktop/package.json` `workspace:*`,含 `ptrLayouts.generated.ts` 固定偏移表 + `component.generated.ts` 的 `ABI_LAYOUT_HASH`)。
+ 2. **wasm 产物**:`desktop/public/wasm/esengine.{js,wasm}`,运行期由 `EngineHost.ts:122-134` 经 `${location.origin}/wasm/esengine.js` 动态 import 加载。
+- **无变体记录 / 无构建溯源**:`build.config.js:158-160` 把 `build/wasm/{web,wechat,playable}` 都映射到 `desktop/public/wasm`。**更正**:三变体**文件名不同**(web=`esengine.js`、wechat=`esengine.wxgame.js`、playable=…),故**共存不覆盖**,编辑器固定加载 `esengine.js`=web——所以这里**不是覆盖歧义**(本文初稿的"谁后跑谁覆盖"判断有误)。真正缺的是:`public/wasm` 里没有任何"这是哪个变体、哪个 git sha、何时构建"的记录,stale 与否只能靠肉眼比对文件时间。
+- **运行时握手是权威 fatal 检查,但晚且只覆盖 layout**:`createWebApp` 以 `{ strict: true }` connect bridge(`app.ts:854`),`BuiltinBridge.ts:341` 对 wasm 自报 `getAbiLayoutHash()` 与 SDK `ABI_LAYOUT_HASH` 不符**始终 fatal 抛错**(`:269`)——所以 **layout 漂移其实已被致命兜住**。但 (a) 只在**运行时、且 instantiate 之后**才触发,无 dev-server 期/实例化前的早检;(b) 只覆盖 **layout**——变体差异是 feature flag、不进 ABI hash,握手抓不到;(c) 依赖 wasm 带 `getAbiLayoutHash`,更老的二进制会静默跳过(`abiMismatch=null`);(d) `ABI_LAYOUT_HASH` 当时**未从 `esengine` 导出**,宿主无法自己比对。
+- dev 内循环:改 `sdk/src`(TS)→ vite 热更,但 `public/wasm` 仍是上次构建拷进来的旧二进制——靠运行时握手碰运气,且报错点深(embind connect 内部)而非接缝处。
+
+### 目标架构(分层:引擎握手权威 fatal + 编辑器 manifest advisory)
+1. **构建溯源 manifest(已实现)**:sync 时在 `public/wasm/` 旁挂 `wasm.manifest.json` `{schema, abiHash, editorTarget, variants, gitSha, builtAt}`。`abiHash` 取自刚生成的 SDK `component.generated.ts`(wasm 与该常量同由 EHT 管线一起生成,故忠实代表二进制的 `getAbiLayoutHash()`)。这补上"哪个变体/哪个 sha/何时"的记录。
+2. **SDK 导出 `ABI_LAYOUT_HASH`(已实现)**:从 `esengine` 顶层导出,宿主/工具链得以自行比对(此前不可达)。
+3. **编辑器 advisory guard(已实现)**:boot 前 fetch manifest,比对 `abiHash`/`editorTarget` 与 SDK 期望,**warn-on-drift / 缺失即 ok**——**刻意非 fatal**:手拷二进制会让 manifest 变陈旧,绝不能因陈旧元数据挡住本来能跑的 boot。权威 fatal 仍是引擎运行时握手(读真实二进制)。guard 把变体识别、构建溯源、早期漂移告警提前到实例化之前、且报在接缝处。
+4. **(未做,可选)dev-server 期守卫**:vite 插件在 dev server 启动时比对 workspace SDK `ABI_LAYOUT_HASH` 与 manifest,红字 overlay,把告警从 boot 再提前到开服时。
+5. **(未做,已重新评估为低优先)按变体分目录**:因三变体文件名本就不同、共存不覆盖,编辑器只取 `esengine.js`,分目录的收益远低于初稿设想;且目录搬迁会改运行时加载路径,需 launch-test,故暂缓。manifest 的 `editorTarget`/`variants` 已足够识别变体漂移。
+
+> 这是 RC10"同步产物打协议版本戳"在编辑器侧的落地点。改动小、纯加法、堵的是最阴的静默漂移。
+
+---
+
+## E2:缺命令边界,World 是事实全局(可绕过抽象)
+
+### 病灶
+- **EngineHost 把 `app` 作为公开 getter 暴露**(`EngineHost.ts:46-48`),于是 `app.world` 对任何 `import { EngineHost }` 的模块都可达。写模块各自独立伸手取 World:`SceneCommands.ts:58/100/...`、`SceneQuery.ts:17/22/...`、`ViewportController`——**World 成了编辑器的事实全局**。
+- **没有单一 command/transaction 入口**。撤销仅在调用方主动绕 `EditorHistory.record(...)` 时才登记(`SceneCommands.ts:118/137/158/178`)。任何代码直接 `world.set(...)`(裸写见 `SceneCommands.ts:96`)都会**静默跳过 undo**——而 `world.ts:371/379/455` 的 `notifyBridge('onComponentChanged')` 照常触发、响应式 UI 照常刷新,于是"漏记 undo"被完全掩盖,回归测试都不易抓。
+- 这正是 RC 系列反复点名的"**可绕过的抽象**"根因家族在编辑器侧的复发:抽象(SceneCommands/EditorHistory)存在,但结构上不强制走它。
+
+### 目标架构
+1. **收口写边界(keystone)**:EngineHost **不再公开 `world`/`app`**;改为只暴露给 `SceneQuery`(读)与 `SceneCommands`(写)两个受信模块(同包 internal 约定或显式 token 注入)。面板一律经这两个门。
+2. **所有写自动成 undo 步**:把 `EditorHistory.record` 内化进 `SceneCommands`——每个 mutating 方法默认开一个事务,调用方无法"忘记"登记。读写分离后,"裸 `world.set` 绕过 undo"在结构上不可能。
+3. **命令对象化(接 RC10)**:把 SceneCommands 的每个操作表达为一个 `EditCommand` 值对象(复用引擎 `commands.ts` 命令类型),`apply(world)` 是唯一执行点。这让命令可序列化——为 RC10 的"editor→runtime 编辑命令 schema"、命令日志、未来 out-of-process 直接铺好路。
+
+> keystone = 第 1 步:把 World 从事实全局降级为两个门后的私有句柄,是 E2 全部收益与 RC10 命令化的共同前置。
+
+---
+
+## E3:桥接是"伪轮询"——带了 payload 却全丢掉
+
+### 病灶
+- `EditorBridge` 的回调签名其实**携带了细粒度信息**:`onComponentChanged(entity, component)`(`context.ts:34`)、`onParentChanged(child, parent)`(`:37`)等都带实体与组件名。
+- 但 `SceneStore.ts:26-42` 把**两个参数全忽略**,每次回调只 `revision++`/`structureRevision++`,然后所有面板 `useSyncExternalStore` 一律**全量重读**(`SceneQuery.readSceneTree` 重建整棵树、`readInspector` 重读整个组件集)。
+- 本质仍是轮询,只是触发器从定时器换成了桥接回调。当前小场景无感,但:单字段编辑 → 全世界重读,**实体规模一上来即 O(n) 抖动**;且它**丢弃了 RC10"类型化变更事件信封"所需的 *what changed***。
+
+### 目标架构
+1. **细粒度脏标记**:SceneStore 改 `revision` 计数器为 `Map<entity, dirtyMask>`(mask 区分 structure / component-data / parent)。回调按 `(entity, component)` 标脏,面板只重读脏掉的实体/组件。`structureRevision` 已做的"结构 vs 数据"两档是正确的雏形,这是它的自然延伸。
+2. **变更事件信封(接 RC10)**:把 bridge 回调归一为一个带版本戳的 `SceneChange` 事件类型(`{kind, entity, component?, parent?}`),SceneStore 消费它而非六个独立回调。这就是 RC10"runtime→editor 变更事件信封"的进程内形态——日后换 `postMessage`/SSE 只换传输、不换语义。
+
+> E3 与 E2 互补:E2 规范 editor→runtime(命令),E3 规范 runtime→editor(事件),合起来即 RC10 的双向协议在进程内的最小落地。
+
+---
+
+## E4:无 edit / play 模式,编辑器 mutate 的是活动调度
+
+### 病灶
+- `EngineHost.ts:175` 调 `app.run()` 后,引擎**每帧 tick 所有系统**;编辑器编辑的是**同一个** World。没有任何 edit-mode / play-mode 状态。
+- **引擎前提其实已就绪**:`app.ts:365 setPaused` / `:369 isPaused` / `:374`(单步 `step_pending_`)/ `:569`(pause 门控)齐全——编辑器从未接(与记忆中"Play/Pause 仍 pending"一致)。
+- 今天不炸,**只因 `SceneLoader.ts:54 → loadSceneData` 把项目用户组件/系统全 SKIP**(`scene.ts:306` `Unknown component type` WARN)。一旦为"真正编辑项目 + 无损保存"(见 E6)去加载项目的组件/系统代码,那些 gameplay 系统就会**在编辑期运行、与编辑器的改动对打**(编辑器刚 set 的 Transform 被物理/动画系统下一帧覆盖)。
+- 这是个**必须拍板的架构岔路**,不是 bug。
+
+### 目标架构
+1. **编辑器模式状态机**:`edit` / `play` / `paused` 三态,落在 `editorStore`;进 `edit` 即 `app.setPaused(true)`,进 `play` 解冻;Toolbar 接 Play/Pause/Step(引擎 API 已具)。
+2. **"编辑期安全系统"分类**:edit-mode 下不能全停——渲染、变换层级、相机、拾取这类必须继续跑,gameplay(物理 tick、脚本、tween、粒子推进)必须冻结。需要给系统一个 `runInEditMode` 标注(或在 SystemSet 层面分组),让调度器在 edit-mode 只跑安全集。这是 E4 的真正工作量所在。
+3. **play-mode 状态隔离**:进 play 前快照 World、退出时还原(借引擎已有的 `ChangeTracker` + scene 重建),让"试玩不脏化编辑场景"成立——同时这也是 E6 无损保存的前置(先能加载项目代码且不互相破坏)。
+
+> 依赖:E4-2 的系统分类是"加载真实项目"的闸门;E4 一通,E6 的保存难题随之解开。
+
+---
+
+## E5:Schema 在接缝两侧各推一遍(RC9-1 的下游受害者)
+
+### 病灶
+- `schema.ts:113-129 inferField` 靠**逐字段嗅探 live JS 值的形状**反推控件类型(数字/bool/vec2/vec3/quat→angle/color),因为 RC9 的富元数据(range/step/tooltip/enum/category)**从未活到 TS**(见 `REARCH_FRONTIER.md` RC9 病灶)。
+- 直接症状:**枚举字段只能渲染成裸数字**(如 `Camera.projectionType`),因为引擎生成的 JS schema 不带 enum 元数据;`componentFields`(`schema.ts:68-77`)遍历 `def._default` 的 key,只能拿到值、拿不到约束。
+- 编辑器侧 `HIDDEN_COMPONENTS`/`ORDER`/per-type 控件(`schema.ts:34-38`)属于合理的**展示策略**(编辑器该 own),但 `inferField` 在**替引擎补它本该提供的类型信息**——这是接缝错位,不是编辑器职责。
+
+### 目标架构
+1. **消费 RC9-1 的富元数据**:RC9-1 让 `ES_PROPERTY` 注解(range/step/tooltip/label/category/hidden/enum)透传到 TS `COMPONENT_META` 后,`inferField` 的形状嗅探退役为**读权威 schema**;enum 渲染成下拉、数值带滑条/范围、字段带 tooltip/分组。
+2. **保持职责划分**:引擎 own"有哪些组件/字段 + 类型 + 约束",编辑器 own"隐藏/标签/顺序/控件外观"。E5 不是把策略搬回引擎,而是**让类型信息从引擎流过来,编辑器停止猜**。
+
+> E5 无独立 keystone——它**纯依赖 RC9-1**。RC9-1 一落地,这里是受益最直接的下游;在此之前 `inferField` 的启发式是可接受的临时桥。
+
+---
+
+## E6:生产打包未解 + 保存有损(结构性,非杂活)
+
+### 病灶
+- **打包未解**:wasm 经 `${location.origin}/wasm/...` 动态 import(`EngineHost.ts:122`)+ `locateFile: /wasm/${p}`(`:131`),场景/纹理经 `/scenes/...` 绝对路径 fetch。dev(http origin)能跑,`file://` 打包**必碎**(`EngineHost.ts:120-121` 注释已自陈)。这决定了 wasm/资产加载该怎么组织,是结构问题。
+- **保存有损**:`serializeScene`(`scene.ts:330`)存在,但因 load 跳过未知用户组件(E4 病灶同源),直接回写原文件会**丢失这些组件**。所以 save 至今未做(与记忆中"save gotcha"一致)。
+
+### 目标架构
+1. **自定义协议 / 相对 base**:打包版用 Electron 自定义协议(如 `estella://wasm/...`)或相对 base 取代绝对路径,wasm + 资产走同一套解析;与 E1-2 的"按变体分目录"一并设计。
+2. **无损保存依赖 E4**:保存正确性的前提是**加载项目的组件/系统代码**(这样 load 不再 SKIP),而那要求 E4 的 edit-mode 冻结先就位(否则加载即互相破坏)。在此之前,save 只能走 Save-As/新文件,**不可**回写覆盖含未知组件的原场景——这条约束应在 UI 上显式化,而非留给用户踩坑。
+
+> **更正(2026-06-19)**:E6 此前默认"保存目标存在",实则**踩空**——架构里没有"工程"一等概念,编辑器也没有写文件的机制。那块地基是 **E7**,是 E6 的真正前置。E6 收窄为"在 E7 的工程根 + fs 桥之上,把 `serializeScene` 写回 `assets/scenes/*.esscene`"。
+
+---
+
+## E7:工程 / 工作区模型(Project & Workspace)—— E6 的前置地基
+
+> 取舍已拍板(2026-06-19):根级 `project.esproj`(提交)+ `.esengine/workspace.json`(本地态)· 固定布局约定 + 清单可选覆盖 · fs 仅 Electron(IPC + 沙箱到工程根)。
+
+### 病灶
+- **架构无 "工程" 一等概念**:`examples/*`(全 18 个)有隐式约定 `{.esengine/settings.json, assets/{scenes,textures}, src/systems}`,但 `.esengine/settings.json` 仅 `{ "lastOpenedScene": "assets/scenes/main.esscene" }`,且**只是 `build-tools/tasks/examples.js` 生成示例的副产物**——SDK 零 project 抽象,编辑器从不读它。
+- **编辑器无工程根**:`SceneLoader.loadInto` 从 `desktop/public/scenes/*.esscene`(`EngineHost.ts` 的 `DEFAULT_SCENE_URL`,dev 拷贝)fetch,不知道工程在哪、也没有"打开工程"流程。
+- **无 fs 机制(机制层硬缺)**:`desktop/electron/preload.ts` 只 `contextBridge` 暴露 `getVersion / getPlatform / reportEngineStatus`——**无 readFile / writeFile / dialog / watch**。编辑器**物理上写不了文件**,只能 fetch `public/`。
+- **后果**:E6 无损保存**无目标可写**;Content Browser 无真实 fs 来源(仍用 `src/mock/sceneData.ts`);E4 留的"加载工程 `src/` 组件代码"**无家可依**。这是 Unity `Assets/`+`ProjectSettings/`、UE `.uproject`、Godot `project.godot` 那一层——Estella 只有 `.esengine/settings.json` 这个胚胎,没长成。
+
+### 目标架构
+1. **工程格式**(双文件,职责分离):
+ - 根级 **`project.esproj`**(JSON,提交进库):`{ formatVersion, name, engineBuildId(接 E1), layout? }`。`layout` 可选——缺省走固定约定,可逐项覆盖。
+ - **`.esengine/workspace.json`**(编辑器本地/瞬态,建议 gitignore):`{ lastOpenedScene, panelLayout, … }`。从现有 `.esengine/settings.json` 迁移(`lastOpenedScene` 搬过来)。
+ - **固定布局约定**:`assets/scenes/*.esscene` · `assets/textures/*`(+`.meta` UUID) · `src/`(工程组件/系统代码) · `.esengine/`(本地态)。
+2. **fs 桥(Electron IPC,沙箱到工程根)**:main 进程 `ipcMain.handle('project:open' | 'fs:read' | 'fs:write' | 'fs:readdir' | 'fs:watch')`;preload 经 `contextBridge` 暴露 `window.estella.project.*` / `window.estella.fs.*`;**所有 fs 路径校验落在已打开工程根内**(拒绝 `..` 越界 / 绝对路径逃逸),防渲染层任意读写。watch 用 chokidar。
+3. **编辑器 Workspace 模型**(`desktop/src/project/`):`ProjectStore`——`openProject(dir)`(选目录→读 `project.esproj`→设根→读 `workspace.json`→打开 `lastOpenedScene`)、路径解析(scene/asset 相对工程根)、`saveScene`(`serializeScene` → `fs.write` 到 `assets/scenes/*.esscene` = **E6 的落地**)。
+4. **资产解析改走工程根**:`SceneLoader` 的 `@uuid:` 解析 + 纹理 manifest 从工程 `assets/` 经 fs 桥读,取代 `public/scenes` dev hack。AssetRegistry / `.meta` UUID 已就绪,只需把根从 public 换成工程根。
+5. **分层**:工程是**编辑器/创作期**概念,落在 `desktop/`(`project.esproj` 的 schema/类型可放共享处);引擎/SDK 保持 project-agnostic(运行时只吃打好的 bundle)。
+
+### 与其他条目的关系
+- **E7 是 E6 的前置**(保存目标 + 写文件机制);接 **E1**(`engineBuildId` 进 manifest);接 **E4**(`src/` 是工程组件/系统代码的家 → 加载后 serialize 不再 skip-unknown → 真·无损保存);喂 **Content Browser**(真实 fs 来源,替换 mock)。
+
+### 执行顺序(可拆、可独立验证)
+- **E7-1 工程格式 schema**:`project.esproj` + `.esengine/workspace.json` 类型 + 固定布局约定 + 读取/校验/旧 `settings.json` 迁移。纯数据 + 主进程可测。
+- **E7-2 fs 桥**:Electron IPC + preload 暴露 + 工程根沙箱校验。主进程单测(越界 reject、watch 回调)。
+- **E7-3 Workspace 模型**:`ProjectStore`、路径解析、`SceneLoader` 改走工程根、打开工程流程。
+- **E7-4 保存(= E6)**:`serializeScene` → `fs.write`,Save / Save-As UI;含 E4 加载 `src/` 后的真·无损覆盖。
+- **examples 迁移**:`build-tools` 加一步把 18 个 examples 升级到新格式(生成 `project.esproj`,`settings.json`→`workspace.json`),保持可在编辑器打开。
+
+### 验证机制
+- **E7-1**:`project.esproj` 解析/校验往返 + 旧 `settings.json` 迁移测试(读胚胎 → 产出新格式 + workspace.json)。
+- **E7-2**:fs 桥沙箱测试——工程根内读写 OK、`..`/绝对路径越界 **reject**;watch 触发回调。
+- **E7-3/4**:打开 examples 工程 → 改场景 → 保存 → 重开,**逐组件一致**(含 E8 加载 `src/` 后原本会被 skip 的用户组件)。
+
+---
+
+## E8:动态加载工程脚本(Dynamic Project Scripts)—— 真编辑/无损保存的最后一块
+
+> 这是贯穿全程的"加载工程代码"缺口的根治方案。E7 让编辑器能开工程、读场景;但工程的**自定义组件/系统**(`src/components.ts`、`src/systems/*.ts`)从不被加载,导致它们在 load 时被 skip、不可编辑、无损保存被卡、play 时不运行。
+
+### 病灶
+- **零动态加载**。用户组件靠**静态 import 进 bundle**:`src/main.ts` `import './components'`(`defineComponent('Wave', …)` 在模块加载时注册)+ `import {waveSystem} from './systems'` + `addSystemToSchedule(…)`。每个 example 由发布构建打成自包含 bundle,组件在 bundle 加载时进 registry。
+- `runtimeLoader.ts` 是**发布期场景/资产加载器**,不加载用户代码(它假设组件已被 bundle 注册)。
+- 编辑器只 `fs.read` 场景 JSON、从不加载工程 `src/` → `getAllRegisteredComponents()` 里没有 Wave/Orbit/FlipDemo → `loadSceneData` skip(`scene.ts:306` WARN)→ 不可见/不可编辑/无损保存被守卫挡住/play 不跑。
+- **仓内没有"把用户 src 打成可运行 bundle"的流水线**(`build` 只构建引擎 wasm/sdk;`check-examples` 只 typecheck)。所以编辑器的工程脚本构建是**新建**的。
+
+> **命门**:`defineComponent` 注册进 `getDefaultContext().componentRegistry`(`component.ts:129`),编辑器 `getAllRegisteredComponents()` 读它。**工程代码 import 的 `esengine` 必须与编辑器是同一个模块实例**(同一个 `getDefaultContext`),否则注册进另一个 registry,编辑器看不到——这是整套设计的成败点。
+
+### 目标架构
+1. **工程脚本构建(esbuild,主进程)**:编辑器用 esbuild(Node API)把工程的脚本入口(`src/main.ts` 或一个约定的注册入口)bundle 成 **单个 ESM**,关键是 **`external: ['esengine','esengine/*']`**——不把 esengine 打进去。产物写到工程的 `.esengine/cache/`(本地、gitignore)。新 IPC `project:buildScripts` → 返回产物路径 + 诊断。
+2. **共享 esengine 实例(import map)**:渲染进程注入一个 import map,把裸 `esengine` 映射到**编辑器已加载的那个 esengine 模块 URL**。`import(产物URL)` 时,产物里的 `import {...} from 'esengine'` 经 import map 解析到同一实例 → 工程的 `defineComponent`/`addSystemToSchedule` 注册进编辑器的 `getDefaultContext()`。
+3. **加载时序**:`open project` → **先 buildScripts + import(产物)**(注册组件/系统)→ **再** load 场景(`resetWorldTo`)。这样 `loadSceneData` 时组件已在 registry,不再 skip → 工程组件可编辑、可序列化(接 E7-4 → 真·无损覆盖,lossy 守卫从"挡"变"放行")。
+4. **用户系统的 edit/play 门控(接 E4)**:工程 `main.ts` 调的是裸 `addSystemToSchedule`(不门控)。编辑器加载工程代码时**自动给工程注册的系统包上 `playModeOnly`**(edit 模式冻结、play 才跑)——可在 flush pending systems 时按"来源=工程"打标。否则用户系统会在编辑期乱跑、和编辑器对打。
+5. **脚本 HMR**:监视工程 `src/`(chokidar,接 E7 fs 桥)→ 改动 → 重 buildScripts → **重置 + 重注册**(`unregisterComponent` 已存在;或 `getDefaultContext()` 局部重置用户组件 + 重 import 带 cache-bust 的产物 URL)→ 重载当前场景。调参/改组件即时生效。
+6. **隔离/安全**:工程 JS 在编辑器渲染进程里执行,能摸到 `window.estella`(fs 桥)。本地开发工具、用户主动打开的工程,风险可接受;**记为已知** + 未来可选:把工程脚本跑在 Web Worker / 独立 realm(但跨 realm 共享 registry 复杂,需权衡)。
+
+### 需要拍板的岔路
+| 岔路 | 选项 | 推荐 |
+|---|---|---|
+| **构建工具** | esbuild(主进程,快,Node API) / Vite 中间件服务(白送 HMR 但服务工程外文件别扭) / 复用某发布构建 | **esbuild**:最简、最快、external 控制精确;HMR 自己接 watch |
+| **共享 esengine** | import map(Chromium 原生) / 全局注入 `window.__esengine` / SystemJS | **import map**:标准、干净 |
+| **系统门控** | 编辑器自动给工程系统包 `playModeOnly` / 要求工程自己门控 | **自动包**:工程无需改代码,edit 期默认冻结 |
+| **隔离** | 主渲染进程(共享 registry 最简,但工程 JS 拿得到 fs 桥) / Worker 沙箱 | **主渲染进程**(local 工具)+ 记风险;Worker 留后 |
+
+### 执行顺序(可拆、每步可验证)
+- **E8-1 esbuild 构建 + IPC**:`project:buildScripts`(external esengine,产物入 `.esengine/cache`)。主进程可单测(产出含 `import 'esengine'` 的 ESM、无内联 esengine)。
+- **E8-2 import map + 动态 import**:渲染层注入 import map(esengine → 编辑器实例)+ `import(产物)`;验证工程 `defineComponent` 后 `getAllRegisteredComponents()` 含该组件。
+- **E8-3 时序接入**:`ProjectStore.loadCurrentScene` 之前先加载脚本;验证开 sprite-rendering → Wave/Orbit **不再 skip**、inspector 可见可编辑。
+- **E8-4 系统门控**:工程系统自动 `playModeOnly`;验证 edit 期工程系统不 tick、play 期跑(接 E4 的 run-mode 测试)。
+- **E8-5 脚本 HMR**:watch src → 重建重注册重载;验证改 `components.ts` 默认值即时生效。
+
+### 验证机制
+- **E8-1**:bundle 产物断言——含 `from "esengine"`(external)、不含 esengine 源码内联。
+- **E8-2**:加载一个最小工程脚本(`defineComponent('Probe',…)`)→ 断言 `getComponent('Probe')` 非空(证明共享了同一 registry/context)。
+- **E8-3**:开含 Wave 的工程 → 断言 `loadSceneData` 零 "Unknown component type" WARN、该实体 inspector 列出 Wave 字段。
+- **E8-4**:edit 期工程系统计数 0、play 期 >0(复用 E4 run-mode 断言)。
+- **E8-5**:改 `Wave.amplitude` 默认值 → HMR → 新建实体取到新默认(无需重启)。
+
+### 与其他条目的关系
+E8 是 **E7-4 真·无损保存**的前置(加载工程代码 → serialize 不再丢未知组件 → lossy 守卫放行);接 **E4**(工程系统的 edit/play 门控);用 **E7** 的 fs 桥(读 src + watch)+ `.esengine/cache`(产物)。
+
+---
+
+## 执行顺序(按 ROI 排,全程保持构建常绿、每项独立验证)
+
+| 档位 | 批次 | 依据 |
+|---|---|---|
+| **立即(独立 / 低风险 / 见效快)** | **E2-1/2** 收口写边界 + 写即 undo、**E1** build id 握手 + wasm 按变体分目录、**E3-1** 细粒度脏标记 | 纯重构/纯加法;E2 当下即消除"静默漏 undo";E1 堵静默变体漂移;均不依赖大改造 |
+| **keystone(解锁后续)** | **E4-2** 编辑期安全系统分类 | 它是"加载真实项目 → 无损保存(E6)"的总闸门;引擎 pause/step API 已就绪,工作量在系统分类 |
+| **地基(E6 的前置)** | **E7** 工程/工作区模型(`project.esproj` + fs 桥 + Workspace)→ 然后 **E6** 无损保存 | 没有工程根 + 写文件机制,保存无目标可写、Content Browser 无真实源;E7 是 E6 物理前提 |
+| **中长期(依赖前置 / 跨仓 / 需拍板)** | **E2-3 + E3-2** 命令/事件对象化(= RC10 进程内落地)、**E5** 富元数据消费(依赖 RC9-1) | 依赖 keystone 或 RC9-1;命令/事件化为未来 out-of-process 铺路 |
+
+> 依赖序:E2-1(World 降级为私有句柄)是 E2 全部收益与 E2-3 命令化的前置;E4-2(系统分类)是 E4-3 与无损保存的前置;**E7(工程模型 + fs 桥)是 E6 的前置**;E5 纯依赖 RC9-1;E3-2 与 E2-3 合起来即 RC10。
+> 核心判断:**先吃 E2/E1/E3-1 三个低垂果实(接缝收口 + 防漂移 + 细粒度刷新,纯重构/加法),同时把 E4-2 立为 keystone**——它解开"加载真实项目"这一步,E6 的保存随之成立。RC10 的协议化(E2-3+E3-2)作为其上的加法层,不插队。
+
+---
+
+## 验证机制(机制即根治成立的证明)
+
+- **E1 产物绑定**:构造一个"故意旧 wasm + 新 SDK"场景,断言 boot **拒绝启动并指明变体/版本**(而非现在 hash-only 通过或静默错行为);dev 守卫用"改 SDK hash 后 dev server 立刻红"验证。
+- **E2 写边界**:结构测试断言**面板无法触达 `world`**(编译期:World 不在 EngineHost 公开 surface);行为测试断言**任意 SceneCommands 调用后 undo 栈 +1**(不存在"绕过 undo"的成功路径)。
+- **E3 脏标记**:断言"编辑实体 A 的一个字段 → 只有 A 的 inspector 重读,树/其它实体零重读"(重读计数断言)。
+- **E4 edit/play**:断言 edit-mode 下 gameplay 系统**不 tick**(物理/tween 计数为 0)、渲染/变换**继续 tick**;play→edit 往返后 World 状态与进 play 前**逐字段一致**(状态隔离)。
+- **E5 富元数据**:端到端往返——`ES_PROPERTY(enum=...)` → `COMPONENT_META` → inspector 渲染成下拉(与 RC9-1 验证共享)。
+- **E6 打包/保存**:打包产物在 `file://`(或自定义协议)下成功 boot;"加载含用户组件场景 → 编辑 → 保存 → 重载"**逐组件一致**(含原本会被 SKIP 的用户组件)。
+
+---
+
+## 需要拍板的架构岔路
+
+| 岔路 | 选项 A | 选项 B(推荐) |
+|---|---|---|
+| **接缝形态** | 立即上 `postMessage`/RPC 协议化 | **保持进程内直连,但收口为命令(E2)+事件(E3)两个门**;协议化(RC10)作为换传输不换语义的加法层 |
+| **edit-mode 系统冻结** | 全停调度,渲染也停(编辑器自己画) | **系统分类:编辑期安全集(渲染/变换/相机/拾取)继续 tick,gameplay 冻结(E4-2)** |
+| **保存策略(短期)** | 直接回写原 `.esscene`(会丢未知组件) | **未加载项目代码前只允许 Save-As / 新文件,UI 显式禁用覆盖保存**;无损覆盖待 E4+项目代码加载就位 |
+| **wasm 变体管理** | 维持三变体覆盖同一目录 | **按变体分目录 + manifest,编辑器显式选变体(E1-2)** |
+| **schema 富化** | 编辑器侧继续扩 `inferField` 启发式 | **等 RC9-1,消费权威元数据(E5)**;在此之前嗅探是可接受临时桥 |
+| **工程清单(E7,已定)** | 扩 `.esengine/settings.json` 单文件 / 根级单文件 `estella.json` | **✅ 根级 `project.esproj`(提交)+ `.esengine/workspace.json`(本地态,gitignore)**;职责分离,像 .uproject + Library/ |
+| **工程布局(E7,已定)** | 完全写死 / 完全清单驱动 | **✅ 固定约定(`assets/scenes`、`assets/textures`、`src/`)+ 清单可选覆盖** |
+| **fs 访问(E7,已定)** | Electron + Web(File System Access) | **✅ 仅 Electron(IPC + 沙箱到工程根)**;编辑器本就 Electron-first |
+
+---
+
+## 实现进度(living status)
+
+- **E2-2(写即 undo / 单一写门):✅ 已实现(2026-06-19)。** 把 undo 记录从面板内化进 `SceneCommands`:新增 `beginGesture(label)`/`endGesture()`,raw writer 降为 module-private 函数 `applyFieldWrite`(未导出),公开 `setField`/`setEntityXY` **一律记 undo**——无 gesture 时各自成步,gesture 内按字段首触捕获 before、`endGesture` 读 after、合并为一步。`Details.tsx`(FieldRow)与 `Viewport.tsx`(拖拽)删除手动 capture+`EditorHistory.record`,改调 gesture API;`EditorHistory.record` 现仅存于 `SceneCommands`(6 处)。
+ - **验证**:`tsc --noEmit`(strict + noUnusedLocals)+ 完整 `vite build` 绿;三条结构不变量 grep 确认——(1) 面板零 `EditorHistory.record`;(2) `applyFieldWrite` 未导出、仅 SceneCommands 内调用;(3) 面板/只读模块零 `world.set/insert/despawn/spawn`。行为等价(focus→blur / 拖拽 / 单击 toggle / 纯点选无误记 / undo·redo 经 raw writer 不重记)经逐场景推演。
+ - **未尽(E2 余项)**:**E2-1 的"硬隔离"**——`EngineHost.app` 仍是公开 getter(引擎层 4 模块合法需要),`desktop/` 无 eslint,故"面板编译期不可触达 world"的 lint 强制延后;当前靠"raw writer private + 公开面只含记 undo 的方法"在结构上堵住主要裂缝。**E2-3(命令对象化,接 RC10)** 未开始。
+- **E1(构建溯源 manifest + 编辑器 advisory guard):✅ 已实现(2026-06-19)。** ① SDK 从 `esengine` 顶层导出 `ABI_LAYOUT_HASH`(`sdk/src/index.ts`,重建 dist);② 新增 `desktop/src/engine/EngineGuard.ts`——`evaluateManifest`(纯函数,可测)+ `checkEngineBuild`(fetch `/wasm/wasm.manifest.json`),比对 `abiHash`/`editorTarget`,warn-on-drift、缺失即 ok、**非 fatal**;③ `EngineHost.boot` 在实例化前调用 guard,warn/info 落控制台;④ `build-tools/tasks/sync.js` 每次 wasm 同步重写 `wasm.manifest.json`(abiHash 取自 `component.generated.ts`、gitSha 取自 `git rev-parse`、builtAt=now);⑤ backfill 当前二进制的 manifest(`desktop/public/wasm/wasm.manifest.json`,abi=`579120e76e895e7c` git=`dcdfda67`)。
+ - **设计修正**:layout 漂移其实已被引擎 strict 握手(`app.ts:854`)**fatal 兜住**,故编辑器侧**刻意做成 advisory**(避免陈旧 manifest 误报挡 boot);新增价值是变体识别 + 构建溯源 + 实例化前/接缝处的早期告警。**按变体分目录**因"文件名不同本就共存"而重新评估为低优先,暂缓(需 launch-test)。
+ - **验证**:编辑器 `tsc --noEmit` + `vite build` 绿(`ABI_LAYOUT_HASH` 从 dist 解析);SDK `rollup` 重建 + dist 含该导出;`node --check` sync.js 通过;guard 四分支语义(absent/match→ok、abi/variant 漂移→warn)经 node 复核;writer 正则从 SDK 源抽出真实 hash 且与 backfill manifest 一致(当前 boot 判 ok,零回归)。**未 launch-test** 运行时告警实际显示(仅编译 + 逻辑 + 无回归路径验证)。
+- **E4(edit/play 模式收口 + 状态下沉 AppContext + 编辑器接线):✅ 基础已落地(2026-06-19)。**
+ - **关键更正**:edit/play 门控机制**早已存在**——`env.ts` 的 `playModeOnly()`(`= !editorMode || playMode`)+ `setEditorMode/isEditor/isRuntime/setPlayMode/isPlayMode`,且 **animation(tween/sprite)、physics step、timeline player、UI 交互(interaction/textinput/focus/drag)、audio、scrollview 早就用 `runIf: playModeOnly` 门控了**。我上一轮加的 `App.setEditMode`/`addGameplaySystemToSchedule` 是**并行的第二套真相**(正是 RC 反复点名的多源真相病根),已**全部回退删除**,统一到 `env.ts`。
+ - **架构升级(不为兼容妥协)**:把 `env.ts` 的**模块级进程全局** `editorMode`/`playMode` **下沉进 `AppContext`**(与 `componentRegistry`/`editorBridge`/`pendingSystems` 同处);`env.ts` 函数签名不变、改为 `getDefaultContext()` 的薄访问层,`AppContext.reset()` 一并复位。**收益**:app-scoped 状态归一到一个 context、消除散落的模块全局、`setDefaultContext` 多-App 时自动隔离 run mode——与 RC 的 context 收口同一条线。这正是 A(env 语义)唯一弱于 B(实例状态)那一维的正确兑现方式。
+ - **分类策略**(沿用既定 `playModeOnly`):推进时间/模拟者(物理 step、粒子/动画/tween/timeline/计时器)= gameplay 冻结;让场景可见可选者(render、transform、相机、UI layout/render-order、资产)= edit-safe 续跑。
+ - **本轮补门控**:`ParticlePlugin`(ParticleSystem)、`timer`(TimerSystem)挂 `runIf: playModeOnly`(原先漏挂)。**spine 暂不动**——其 `spineUpdateSystem` 把"算姿势"与"按 dt 推进"耦合,整体 `runIf` 跳过可能导致 edit 模式不推姿势→渲染异常;正确做法是 **edit 模式传 `dt=0` 而非跳过系统**,但改 spine 内部我无法运行时验证渲染,故记为带方案的跟进。
+ - **编辑器**:`EngineHost.boot` 调 `setEditorMode(true)`+`setPlayMode(false)`(开在 edit 态);`setRunMode(isPlaying,isPaused)` = `setPlayMode(isPlaying)` + `app.setPaused(playing&&paused)`;`App.tsx` useEffect 同步 `editorStore` 的 play/pause(Toolbar 的 Play 已接 `togglePlay`)。
+ - **验证**:新增 `sdk/tests/run-mode.test.ts`(5 用例:默认 runtime、edit 冻结/play 放行、状态在 AppContext 上 + reset、调度器跳过门控系统/edit-safe 续跑、runtime 恒跑)→ **全 SDK 套件 2158 passed**(零回归——证明 env→AppContext 重构不影响 6 个用 `playModeOnly` 的现成插件);编辑器 `tsc --noEmit` + `vite build` 绿;dist 已无 `setEditMode`/`addGameplaySystemToSchedule`(并行机制彻底退干净)。**未 launch-test** 真实运行时冻结表现。
+ - **未尽(E4 跟进)**:① **spine** 改 `dt=0`-in-edit(而非跳过);② **E4-3 play 态状态隔离**(进 play 前快照 World、退出还原),是 **E6 无损保存**前置;③ Toolbar 的 Pause/Step 接 `togglePause`/`stepFrame`;④ (可选,长线)把 run mode 进一步做成 ECS Resource 供 `Res()` 读取——但需改 runIf 模型,收益有限,暂不做。
+- **序列化现代化(= `REARCH_FRONTIER.md` RC9-2,E4-3 的前置):✅ 已落地(2026-06-19)。** 评估 `scene.ts` 后发现核心机制(两趟加载 + id 重映射 + 反射驱动实体/资产字段 + 层级单一真相)规范现代,但迁移/版本与 load 副作用有真债。本轮根治:
+ - **版本化迁移框架**(抬 `prefab/migrate.ts` 模式):新增 `migrateSceneData(raw) → {data, migrated, fromVersion, toVersion}`——读 `version`(此前死字段)、**版本过新即拒绝**、盖 `SCENE_FORMAT_VERSION`;那 4 个散落硬编码迁移(`migrateToUIRenderer`、`Local/WorldTransform→Transform`、`UIRect.anchor→anchorMin/Max`、`UIMask.mode` 串→int)收编为幂等、shape-driven 的迁移步,`loadComponent` 变纯(只 validate+insert)。
+ - **load 不再变异输入**:`migrateSceneData` JSON 深克隆(`prefab/clone.ts` 同款、全平台安全),`loadSceneData`/`loadSceneWithAssets` 全程操作克隆——**快照可反复重载**(直接解 E4-3 的快照复用)。
+ - **组件序列化 codec 注册表**(#3):`registerSceneComponentCodec(type, {exportData, outOfBandFields, importData})` 替换硬编码的 TilemapLayer 特例;`tilemapPlugin` 注册 chunks codec。**`scene.ts` 自此零 tilemap 耦合**,通用序列化器不再认识任何具体组件。
+ - **验证**:`migrateSceneData` 8 用例(各迁移 / migrated 标志 / 版本盖戳 / **拒绝过新** / **非变异**)+ codec out-of-band 往返用例;**全 SDK 套件 2161 passed**(净 +3,零回归——证明对 scene/tilemap/prefab/所有用 load 的路径无影响);3 个旧 `loadSceneWithAssets` 测试从"断言输入被原地改"改为断言真实结果(spawned handle);编辑器 build 绿。
+ - **未尽**:`visible===false` 仍会丢实体(半成品输入字段,语义混乱)+ 二进制/delta 编码——记为后续。
+- **E4-3(play 态状态隔离):✅ 已落地(2026-06-19)**,建在上面的非变异序列化地基上。
+ - **引擎**:新增可复用原语 `resetWorldTo(world, sceneData)`(despawn 全部 + `loadSceneData`,返回 old→new 映射);因 `loadSceneData` 已非变异,同一快照可反复还原。
+ - **编辑器**:`EngineHost.setRunMode` 检测 edit↔play 跳变——进 play 时 `serializeScene(world)` 快照、Stop 时 `resetWorldTo(snapshot)` 还原,返回 `restored` 布尔;`App.tsx` 在 restored 时 `select(null)`(还原后实体 id 变,选择失效)。**试玩不再脏化编辑场景。**
+ - **验证**:`resetWorldTo` 2 用例(despawn-all + reload 把 mutate 过的世界还原到快照、同一快照反复还原)→ **全 SDK 套件 2163 passed**(零回归);编辑器 build 绿。**未 launch-test** 真实试玩→Stop 的视觉还原。
+ - **未尽**:还原后**选择重映射**(现在直接清空;`loadSceneData` 返回的 old→new 映射 + `EntityHandles` 可做精确重映射);play 态**资源**状态(Time 等)不快照(仅实体/组件)——对编辑足够,记为已知边界。
+- **E4 全量分类剩项**:animation/spine/timeline/audio 等其余 gameplay 系统的 `playModeOnly` 打标(spine 需 `dt=0`-in-edit 而非跳过)。
+- **E7-1(工程格式)+ E7-2(fs 桥):✅ 已落地(2026-06-19)。** 取舍已拍板并实现(不做旧 `settings.json` 兼容读取层——按"现代化、不为兼容妥协")。
+ - **E7-1 格式**:`desktop/src/project/format.ts`(纯 TS、零 node/electron 依赖,main+preload+renderer 共用)——`ProjectManifest`(`project.esproj`:formatVersion/name/engineBuildId/layout?)、`WorkspaceState`(`.esengine/workspace.json`)、`ProjectLayout` + `DEFAULT_LAYOUT`(`assets/scenes`、`assets/textures`、`src`)、`parseManifest`(校验 + **版本过新即拒绝**,镜像 scene 迁移)、`resolveLayout`(默认 + 清单覆盖)。
+ - **E7-2 fs 桥**:`desktop/electron/projectFs.ts`(main 专用,node fs)——`openProject`(读 + 校验 `project.esproj`,载 workspace)、`readInRoot/writeInRoot/readDirInRoot/saveWorkspace`,全部经 **`resolveInRoot`** 沙箱(`..`/绝对路径越界 reject)。`main.ts` 持有 `projectRoot`(权威在主进程)+ 注册 `project:openDialog|open`、`fs:read|write|readdir`、`workspace:save`;`preload.ts` 经 `contextBridge` 暴露 `window.estella.{project,fs,workspace}`(fs 路径均工程根相对)。
+ - **验证**:`resolveInRoot` node 复核(工程内 OK、`../`/`assets/../../x`/绝对路径 reject);编辑器 `tsc --noEmit` + `vite build`(main+preload+renderer 跨 IPC 类型)绿。**未 launch-test** 真实 dialog/IPC 读写往返(需运行 Electron)。
+- **E7-3(Workspace 模型 + 打开工程):✅ 已落地(2026-06-19)。**
+ - **examples 迁移**:18 个 example 目录全部转新格式(`project.esproj` 提交身份 + `.esengine/workspace.json` 本地态、保留 lastOpenedScene,删 `settings.json`)。作为真实工程 fixture。
+ - **ProjectStore**(`desktop/src/project/ProjectStore.ts`):渲染层包 `window.estella.{project,fs}`——`openViaDialog`/`open(root)` → `adopt`(resolveLayout)→ `loadCurrentScene`(经 `fs.read` 读 `workspace.lastOpenedScene` → `@uuid:` blank 到 0 → **复用 `resetWorldTo` 载入活动 World**)。subscribe-able。
+ - **接线**:`App.tsx` 加 **Cmd/Ctrl+O** → `ProjectStore.openViaDialog()`(成功后 `select(null)`,因 id 变)。**加法式**:EngineHost boot 仍走 public/scenes 默认(不破现有路径),"打开工程"是叠加能力。
+ - **验证**:examples 迁移脚本已跑 + 抽查无误;编辑器 `tsc`+`vite build` 绿(ProjectStore 跨 IPC 类型、`window.estella.project/fs`、resetWorldTo/SceneData)。**未 launch-test** 真实 dialog→fs.read→resetWorldTo 往返(需 Electron)。
+ - **本轮限制**:工程纹理 `@uuid:` 暂 blank 到 0(纯色)——真纹理需 **E6-1 自定义协议**(`estella://` 服务工程根,顺带解 file:// 打包);StatusBar 未显示工程名(ProjectStore 已 subscribe-ready)。
+- **E7-4(保存 = E6):✅ 已落地(2026-06-19)。** open↔save 闭环成形。
+ - **无损守卫(核心)**:load 时 `unknownComponentTypes(scene)` 比对场景组件类型 vs 引擎注册表;含未注册类型(如 Wave/Orbit/FlipDemo,其 `src/` 代码未加载)即标 `lossy`。**`save()`(覆盖当前场景)在 lossy 时拒绝**——避免静默 clobber 掉 load 时被 drop 的组件(正是贯穿全程的 E6 gotcha)。
+ - **ProjectStore**:`serializeCurrent`(`serializeScene(world, name)`)、`save()`(覆盖,lossy 守卫)、`saveAs(rel)`(显式写新路径,无守卫)、`saveAsViaDialog()`(经 `project.saveSceneDialog` 选目标);保存后 `workspace.lastOpenedScene` 持久化(`workspace:save`)。
+ - **Save-As 对话框**:main `project:saveDialog`(`showSaveDialog`,**校验目标在工程根内**,返回工程相对路径);preload 暴露 `project.saveSceneDialog`。
+ - **接线**:`App.tsx` **⌘S**(覆盖,失败/有损时自动转 Save-As)/ **⇧⌘S**(Save-As)。
+ - **验证**:编辑器 `tsc`+`vite build` 绿(save/saveAs 跨 IPC、`serializeScene`/`getComponent`)。**未 launch-test** 真实 ⌘S→serialize→`fs.write`→落盘往返(需 Electron);`serializeScene` 本身 SDK 2161 测试覆盖、fs.write+沙箱 E7-2 已验。
+ - **本轮限制**:**真·无损覆盖**(含用户组件)仍需加载工程 `src/` 组件代码——未做,故 lossy 场景只能 Save-As(守卫正确地挡住覆盖,而非冒险放行)。
+- **E6-1(`estella://` 自定义协议 + 工程纹理):✅ 已落地(2026-06-19)。**
+ - **协议**(`electron/main.ts`):`registerSchemesAsPrivileged`(`estella`,standard/secure/supportFetchAPI/stream,app ready 前)+ `protocol.handle('estella', …)`(ready 后)——`estella://project/<rel>` → 经 `resolveInRoot` 沙箱读工程根文件、按扩展名给 content-type 返回 `Response`。**安全**:URL 解析把 `..` 钳制在 host 根(越不过 authority)+ `resolveInRoot` 双重守卫,越界不可能。CSP 加 `estella:`(connect-src + img-src)。
+ - **纹理解析**(`ProjectStore`):load 时收集场景 `@uuid:` → 扫 `assets/textures/*.meta` 建 uuid→path(仅被引用的)→ `assets.loadTexture('estella://project/<path>')` 得 handle → `mapAssetRefs` 把 ref 换成 handle(`HttpBackend.fetchBinary` 走 `fetch`,协议可拦)。**save 反向**:记 handle→uuid,`serializeCurrent` 按 `getComponentAssetFields` 把纹理字段 handle 还原成 `@uuid:`(只动资产字段,不误伤 layer/size),保存仍可移植。
+ - **验证**:协议 URL→relpath 沙箱 node 复核(`..` 经 URL 规范化钳在根内);编辑器 `tsc`+`vite build` 绿(main 侧 Response/URL/protocol、ProjectStore 纹理解析+反向跨 IPC)。**未 launch-test** 真实 fetch→GL 上传→显示 + open→改→save 往返(需 Electron)。
+ - **本轮限制**:仅纹理(material/font `@uuid:` 仍 blank 到 0,其 dir 未扫);textures 仅扫 `layout.textures` 顶层(子目录待递归);wasm 仍走 public(协议可复用于 file:// 打包,留待打包任务)。
+- **E6:✅ 达成**(open↔save + 工程纹理显示;真·无损覆盖待加载工程 `src/` 代码)。
+- **E7-5(Launcher / 项目浏览器,静态 UI):✅ 已落地(2026-06-19)。** 编辑器启动先进 Launcher(借 UE5 Project Browser 结构:Recent / New-from-template / Open),套 Estella "stellar instrument" 身份(`launcher.css` 全用 tokens:淡星场背景、hover `--star-glow`、左轨静态星座 signature)。`desktop/src/launcher/Launcher.tsx`(Recent/New 双视图,mock 数据)+ `editorStore.showLauncher`(默认 true,`enterEditor` 切编辑壳)+ App.tsx gating。**静态**:卡片/Open/Create 暂只 `enterEditor()`;待接 **recents IPC**(`userData/recents.json`)、**`project:createFromTemplate`**(拷 example + 写 `project.esproj`)、真缩略图(经 `estella://` 读 example `thumbnail.png`)、gating 改由 `ProjectStore.hasProject` 驱动。编辑器 build 绿。**未 launch-test** 视觉。
+- **E3 / E5:📋 已立项**,未开始。
+- **E7-6(Launcher 接线 + 工程格式收口):✅ 已落地(2026-06-19)。**
+ - **接线**:Recent/Open/New 全接 `ProjectStore`——`recents:list/add`(`userData/estella-recents.json`,真缩略图 data URL + 构建徽章)、`templates:list`(列 examples)、`project:createFromTemplate`(拷模板+改 manifest name)、`project:chooseDirectory`;时序经 `EngineHost.setSceneBootstrap`(工程场景在引擎 ready 后加载、纹理走 `estella://`,不再默认 public 占位)。
+ - **格式收口(纠错)**:我此前自造的 `project.esproj` 是**重复格式**——既有 `project.esproject`(被 build-tools 当工程标记、含 `defaultScene`/`designResolution`/`spineVersion` 等运行时字段)才是单一真相。**统一到 `project.esproject`**:并入我的 `formatVersion`+迁移/拒绝过新 + 提交身份 vs 编辑器本地态分离(`.esengine/workspace.json` 只放 lastOpenedScene/panel),schema 重写为并集(formatVersion/name/version/engineBuildId/defaultScene/designResolution/spineVersion/layout/description/tag,丢 churny 的 modified/created)。`format.ts`/`projectFs`/`launcher`/`ProjectStore` 全改读 `.esproject`;**删掉 18 个 examples 里我造的 `.esproj` + `workspace.json`**,把它们的既有 `.esproject` 重写成统一 schema(build-tools 只检存在、不受影响)。白赚:编辑器用上 `defaultScene`(真入口场景)+ `designResolution`(可驱动 viewport)+ `engineBuildId`(接 E1)。
+ - **验证**:编辑器 `tsc`+`vite build` 绿;迁移脚本已跑、18 个 `.esproject` 统一、无残留 `.esproj`。**未 launch-test** 真实开/建工程往返。
+- 下一步建议:**加载工程 `src/` 组件代码**(动态加载——解开真·无损覆盖 + 跑用户系统,接 E4;当前零动态加载,用户组件靠静态 import 进 bundle);或 **E3-1 细粒度脏标记**;或收尾(模板 description/tag、material/font 协议解析、工具栏激活态)。**强烈建议先 launch-test 一轮**给 E7+E6-1 真实验证。
+- 与既有文档的关系:E3/E2-3 是 `REARCH_FRONTIER.md` RC10 的进程内具体化;E5 依赖 RC9-1;本文不改 RC7/RC8 的引擎内部现代化排序。
+</content>
+</invoke>
diff --git a/docs/REARCH_FRONTIER.md b/docs/REARCH_FRONTIER.md
new file mode 100644
index 000000000..040e93d8f
--- /dev/null
+++ b/docs/REARCH_FRONTIER.md
@@ -0,0 +1,186 @@
+# Estella 能力前沿现代化方案(Capability Frontier Re-architecture)
+
+> 目标读者:引擎维护者 / AI 协作代理。
+> 本文是 `REARCHITECTURE.md` 的**续篇**,体例一致:描述目标架构与根治路径,而非现状。
+> 现状审计见各小节"病灶"引用的 `file:line`(2026-06 全仓只读审计,4 路并行 + 交叉印证)。
+> **与 RC1–RC6 的区别**:
+> - RC1–RC5 根治**正确性根因**(多源真相、可绕过抽象、存储/身份/错误模型)。
+> - RC6 根治**资产/平台能力错配**(压缩纹理、内容寻址、显存预算、分包流式)。
+> - 本文(RC7–RC11)根治**能力前沿错配**:引擎在 RC1–RC6 后将"功能正确、地基干净",但其**性能上限、渲染后端、数据驱动深度、编辑器协议、联网能力**仍停在"能跑"而非"最先进"。这不是 bug,是**未建立的能力**——区别于 RC1–RC5 的"已建立但有缺陷"。
+
+---
+
+## 0. 核心诊断:一条横切约束 + 一片能力空白
+
+### 0.1 横切约束(决定所有排序):主战场是微信小游戏 + playable
+
+构建目标以 `wechat` / `playable` 为一等公民(`build-tools/build.config.js:21-128`)。这条现实约束**否决了"按技术新潮排序"**:
+
+- **WebGPU**:微信小游戏端支持不普及 → 必须 WebGL2 回退共存,不能 all-in。
+- **wasm threads(`-pthread`/SharedArrayBuffer)**:微信环境 SAB 受限、需 COOP/COEP 头 → 需双构建分叉,不能作为默认。
+- **Wasm SIMD(`-msimd128`)**:旧机型/旧 WebView 支持不全 → 需 no-SIMD 回退构建。
+
+**原则**:凡涉及 web-only 前沿特性者,一律设计为 **web 优先 + 微信回退共存**;keystone 优先选那些"在 WebGL2 / 单线程基线下就有收益"的改造,让前沿特性成为纯加法的升级层,而非主线依赖。
+
+### 0.2 能力空白:RC1–RC6 未触及的五个维度
+
+| 维度 | RC1–RC6 状态 | 本文 |
+|---|---|---|
+| 渲染后端 | 纯 WebGL2,零 WebGPU;管线命令式、无 render graph、无实例化 | **RC7** |
+| ECS 执行性能 | 调度信息齐备但单线程串行、零 SIMD(主模块)、math 纯标量 | **RC8** |
+| 数据驱动 / 反射深度 | 反射刻意停在 ABI 层,富元数据从未存活到 TS | **RC9** |
+| 编辑器 ↔ 运行时协议 | 无版本化协议,进程内 mutate 单例;热重载全量丢状态 | **RC10** |
+| 网络复制 / 多人 | 概念完全为零 | **RC11** |
+
+**根治原则**:每条主线先找到**在基线下就有收益的 keystone**,把前沿特性挂成它之上的加法层;凡半成品已在仓者(实例化粒子、变体系统、prefab 迁移框架)优先**激活而非新建**。
+
+---
+
+## RC7:渲染后端现代化
+
+### 病灶
+- **后端纯 WebGL2/GLES3,零 WebGPU**:全 7 套构建配置写死 `-sUSE_WEBGL2=1 -sFULL_ES3=1`(`cmake/Emscripten.cmake`,各档)。`GfxDevice.hpp:4` 注释口头提到 "WebGPU/Vulkan" 但**仅 `GLDevice` 一个实现**(`GLDevice.hpp:29`)。
+- **实例化是死代码**:`GfxDevice::drawElementsInstanced`(`GfxDevice.hpp:249`)、`vertexAttribDivisor`(`:236`)已实现于 `GLDevice` 但**零调用者**;`PARTICLE_INSTANCE_VERTEX/FRAGMENT` 实例化 shader(`Shader.hpp:310-358`)写好却**零引用**。粒子实走 CPU 逐粒子展开 4 顶点 + sin/cos 旋转(`ParticlePlugin.cpp:82-149`),WASM 单线程下每帧重建整个顶点流。
+- **多纹理批能力闲置**:`DrawCommand` 支持 8 纹理槽(`DrawCommand.hpp:14`),`DrawList::execute` 已能多槽绑定,但提交侧只填 `texture_count=1`(`RenderFrameSubmit.cpp:49`、`ParticlePlugin.cpp:159`)——**不同纹理立即断批**。
+- **GfxDevice 抽象层级过低**:接口是 "一个方法 = 一次 glXxx" 的瘦封装(`GfxDevice.hpp:37` 自述 1:1)。WebGL 概念漏满签名——VAO(`:220-236`)、散装 `glUniform*`(`:170-188`)、immediate-bind(`:204-213`)、GLSL 源码直传(`:153-155`)、裸 `u32` 资源句柄、WebGL-only 枚举(`pixelStorei`/`setUnpackFlipY`,`:290/298`)。这些在 WebGPU 里**无对应物**,故现状下无法新增 `WebGPUDevice : public GfxDevice`。
+- **无 render graph / 无 MRT**:管线命令式 collect→sort→merge→flush(`RenderFrame.cpp`);`RenderStage` 仅 4 固定档(`RenderStage.hpp`),非可声明 pass 图;后处理是线性 ping-pong FBO 链(`PostProcessPipeline.hpp:230-231`),全仓 `drawBuffers`/`COLOR_ATTACHMENT1` 零命中。
+- **shader 变体系统闲置 + 来源分裂**:`#pragma variant` 解析存在(`ShaderParser.cpp:194-225`)但 8 个 `.esshader` 一个没用,运行期变化全靠 uber-shader 的 uniform int 分支(`ui.esshader:24-26`);GLSL 两套来源(`.esshader` 文件 + `Shader.hpp`/`PostProcessPipeline.cpp:24-48` 内联字符串);存在 ES1.0/ES3.0 混用与 `EXT_MESH_*` 老语法残留(`Shader.hpp:242-272`)。
+
+> **亮点(不动)**:排序/合并做得扎实——`DrawCommand::buildSortKey` 把 stage/layer/shader/blend/texture/depth 打成 u64(`DrawCommand.hpp:45-69`),`DrawList::finalize` 相邻连续 index 合并为单次大 `drawElements`(`DrawList.cpp:18-58`);`TransientBufferPool` 按 `LayoutId` 分 VBO 解决 baseVertex 截断;collect 阶段经 `RenderTypePlugin` 接口**已后端无关**——GL 泄漏集中在 `DrawList::execute` 与资源类,边界清晰。
+
+### 目标架构
+1. **激活实例化(纯加法,半成品已在仓)**:`DrawCommand` 加 `instance_count` 字段 + instanced 分支;`ParticlePlugin` 改走 per-instance 数据流(pos/size/rotation/color/uv),4 顶点 quad + divisor,接上已写好的 `PARTICLE_INSTANCE` shader。带宽降 ~75%,CPU 顶点重建开销大降。
+2. **多纹理批合并**:`BatchVertex` 加 texIndex/texLayer 通道;`DrawList::finalize` 合并放宽到多槽;batch fragment shader 改 `sampler2DArray`(GLES3 核心,零扩展)。多图集/字体场景 draw call 显著下降。
+3. **抬升 GfxDevice 抽象(keystone)**:把 §病灶列的 GL 泄漏收敛为后端无关模型——`PipelineState`(shader + 顶点布局 + blend/depth/stencil 不可变对象)、`BindGroup`(资源集合)、命令编码、UBO 替代散装 uniform、类型化资源句柄。**主重写点是 `DrawList::execute`(`DrawList.cpp:60-131`)**;collect 阶段不动。**在纯 WebGL2 下先落地即有收益(UBO 减少 uniform 调用)。**
+4. **WebGPU 后端(加法层,依赖 3)**:抽象抬升后新增 `WebGPUDevice : public GfxDevice` + GLSL→WGSL 翻译(Tint/naga,或把 `.esshader` 作者语言迁 WGSL);微信保留 WebGL2 回退(双后端架构天然容纳)。解锁 compute shader(粒子/裁剪 GPU 化)。
+5. **后处理 → 小型 render graph + MRT**:pass 链改声明式(输入/输出资源 + 依赖),调度器分配/复用 transient FBO;`Framebuffer` 加多 color attachment(GLES3 核心 `drawBuffers`)。
+6. **shader 变体系统 + 单一来源**:扩 `ShaderParser` 支持 feature-keyword permutation(编译期 `#define` 注入 + 变体缓存);内联 GLSL 收编进 `.esshader`;统一升 `#version 300 es`,删 ES1.0 回退与 `PARTICLE_INSTANCE` 之外的死 shader。
+
+> keystone = 第 3 步:它是 WebGPU(4)、UBO、未来任何后端的唯一前置,且基线下先落地就有收益。第 1/2/6 步与之正交,可先行。
+
+---
+
+## RC8:ECS 执行性能
+
+### 病灶
+- **两套 ECS 并存**:C++ 核心是存储层(每组件一个分页 `SparseSet<T>`,`SPARSE_PAGE_SIZE=4096`,`SparseSet.hpp:149`);SDK 里另有一套**完整 Bevy 式 TS 用户态 ECS**(schedule/query/command-buffer/change-detection),是游戏逻辑实际编写与调度处(`app.ts:689-809`)。
+- **调度器有信息却不并行**:系统已声明读写集(`Mut` = 写、`Query`/`Res` = 读,`system.ts:52-60`),`sortSystems()` 做拓扑排序 + 环检测(`app.ts:689-767`),但执行是单 for 循环串行 `await`(`app.ts:803`)——**只排序、不做冲突分析、零并行**。
+- **零多线程**:全仓 `std::thread`/`pthread`/`SharedArrayBuffer`/`Atomics` 零命中;link flags 无 `-pthread`/`-sUSE_PTHREADS`(`Emscripten.cmake` 全档单线程)。
+- **SIMD 仅物理侧**:`-msimd128` 只在 Box2D side-module(`Emscripten.cmake:368-378`),主模块/渲染/spine 不开;`src/` 无 `<wasm_simd128.h>`/`v128_t`。
+- **math 纯标量**:`Math.hpp:20-28` 只设 `GLM_FORCE_RADIANS` 等,**无任何 `GLM_FORCE_SSE*/NEON/SIMD/DEFAULT_ALIGNED`** → GLM 走标量默认实现;TransformSystem 的 mat4 乘法逐分量标量。
+- **C++ 侧延迟很初级**:`View::each` 用整池 `std::vector` 快照拷贝容忍迭代内增删(`View.hpp:273-274`)——每帧每查询一次堆分配;延迟逻辑散落(`TweenSystem.cpp:72` 手搓 pending、`Signal.hpp` pendingAdds),无统一 command buffer 抽象。
+
+> **亮点(不动)**:SDK 侧 command buffer(`commands.ts`,系统结束自动 flush)、变更检测(`ChangeTracker.ts` 按 tick)、`RemovedQuery`、`SystemSet`/`runIf` 已是相当现代的特性集。
+
+### 目标架构
+1. **SIMD math(低风险独立,keystone-low)**:`Math.hpp` 开 GLM SIMD 后端 + `GLM_FORCE_DEFAULT_ALIGNED_GENTYPES`;主模块 + 渲染热路径加 `-msimd128`(物理侧已验证可用);微信出 no-SIMD 回退构建。**关键 caveat**:开对齐会改组件 struct 布局,而零拷贝靠 `ptrLayouts.generated.ts` 固定偏移——必须重新生成偏移表,**RC1 的 ABI hash 握手 + `static_assert(offsetof)` 正是这个改动的安全网**(改错即启动拒绝/编译失败)。
+2. **自动并行调度**:用已声明的读写集构建系统冲突图,把拓扑序升级为"按组件读写冲突分组并行批次"(Bevy 式)。**先在单线程上做冲突分析 + 确定性验证**(拿到收益且为并行铺路);真并行作为加法层依赖第 4 步。
+3. **C++ 统一 command buffer**:把散落的延迟逻辑收敛为单一 deferred 抽象,消除 `View::each` 每帧快照分配,并为并发结构变更提供单一安全入口;语义对齐 SDK `CommandsInstance`。
+4. **wasm threads 工作线程池(加法层,受平台约束)**:`Emscripten.cmake` 加 `-pthread -sUSE_PTHREADS -sPROXY_TO_PTHREAD -sSHARED_MEMORY`,解锁数据并行(变换层级、粒子);微信因 SAB 受限走双构建。**高风险,排在最后。**
+
+> **存储模型已拍板**:**不上 archetype**(会推翻 RC2 的"单一 SparseSet"统一计划 + 破坏 `ptrLayouts` 稳定指针契约)。如需固定组合的连续遍历,做 EnTT owning-group(增量维护交集连续布局,与 RC2 兼容),不做全量 archetype 重构。
+
+---
+
+## RC9:数据驱动 / 反射深化
+
+### 病灶
+- **反射刻意停在 ABI 层**:`ES_COMPONENT`/`ES_PROPERTY` 是**空宏**(`Reflection.hpp:35,56`),反射靠 EHT 正则解析(`tools/eht/parser.py`)。注解白名单仅 5 个(asset/animatable/anim_override/entity_ref/readonly,`parser.py:102`)。
+- **富编辑器元数据全缺**:无 range/step/slider、无 tooltip、无 DisplayName、无真分组(category 退化为组件名)、无 hidden、无网络复制标记。
+- **富元数据从未存活到 TS(关键)**:C++ 侧生成了 `editor_getComponentSchema` JSON(`editor_api.py`),但**TS 侧零消费**;`component.generated.ts` 的 `COMPONENT_META` 只带值 + 轻量标签(defaults/assetFields/entityFields/colorFields/animatableFields),全文件无 min/max/step/tooltip/label/category。
+- **scene 迁移无框架**:prefab 迁移是**真·版本化、幂等**的(`prefab/migrate.ts`,`PREFAB_FORMAT_VERSION`,加载自动应用)——很好;但 scene 迁移是散落硬编码命令式特例(`scene.ts:156-179,267-282`),`version:'1.0'` 字段**写了从不读分支**(死字段),无"格式版本过新即拒绝"守卫。
+- **TS 用户组件是二等公民**:`animatableFields` 恒空、colorKeys 靠 `detectColorKeys` 启发式(`component.ts:236-249`),元数据形状与 C++ builtin 不同构。
+
+> **亮点(不动)**:prefab 的 8 种 override / 嵌套 / 变体 / diff / 校验是 **Unity 级**;资产引用 = 稳定 UUID GUID(`.meta` 旁挂、改名不破引用、`AssetRegistry` 双 map);ABI 三重握手(组件方法存在性 + 自报组件表 + layout hash,`BuiltinBridge.ts:385-438`)。弱点集中在 **scene 格式本身**(冗长美化 JSON、无二进制、无 delta)。
+
+### 目标架构
+1. **富元数据单一权威源(keystone)**:给 `ES_PROPERTY` 扩注解词汇(`range=`/`step=`/`tooltip=`/`label=`/`category=`/`hidden`/`replicated`/`skip_serialize`),在 `parser.py` 透传,从 `MetadataGenerator` 发到 TS `COMPONENT_META`(而非只进 C++ 的 `editor_getComponentSchema`)。**一处注解,三处受益**:带约束的精修 inspector + 声明式序列化策略 + 网络复制声明(RC11 前置)。
+2. **序列化版本迁移框架**:把 `prefab/migrate.ts` 的版本化幂等模式提升为通用框架套到 scene;让 serializer 写真版本号、loader 按版本分支、加"版本过新即拒绝"守卫。
+3. **TS 用户组件与 builtin 同构**:`defineComponent` 扩为 schema-builder(字段级 `f.float({min,max}).tooltip()`),让纯 TS 组件进同一 inspector/序列化/复制管线,元数据形状与 EHT 产出对齐。
+
+> keystone = 第 1 步:它是 RC9 第 3 步、RC10 inspector、RC11 复制声明的共同杠杆。`ES_PROPERTY` 当前是空宏,扩它是纯加法。
+
+---
+
+## RC10:编辑器 ↔ 运行时协议
+
+### 病灶
+- **无版本化、类型化协议**:编辑器与运行时同 JS realm,靠**直接 mutate 共享单例** `AppContext.editorBridge`(`context.ts:56`)+ 观察者回调(`EditorBridge`,`context.ts:18-38`)接入,无握手、无信封、无版本戳;`postMessage`/`rpc`/`jsonrpc` 全仓零命中。
+- **同步是隐式文件布局契约**:`syncToDesktop` 纯 `fs.cp` 拷贝(`build-tools/tasks/sync.js:7-44`),无 manifest、无版本戳;唯一"类型化"部分是 bundle 里的 `.d.ts`。
+- **热重载全量丢状态**:`PreviewPlugin.reloadScene()`(`preview/PreviewPlugin.ts:191-201`)= `SceneManager.switchTo('__preview__')` 整场景拆毁重建、重 fetch JSON、重载所有资产,**不保留任何实体/组件状态**;`runtimeLoader.ts` 是一次性加载器,无增量路径。SSE 服务器不在本仓(仅见客户端 `EventSource` 连 `/sse-reload`)。
+
+### 目标架构
+1. **版本化命令/事件契约**:把隐式接缝(`EditorBridge`、`inputRouter.setEditorHandler`、`transaction.ts`、SSE)收敛为显式 `attachEditor(version, bridge)` 握手 + editor→runtime 编辑命令 schema(复用 `commands.ts` 命令类型)+ runtime→editor 变更事件信封;同步产物打协议版本戳。为未来 out-of-process / 远程编辑铺路。
+2. **状态保留热重载 / 场景 live-patch**:借 `prefab/diff.ts:49` 的 diff 思路做 scene-diff → 增量 apply(insert/remove/setField),保留运行时状态;World 已有 `ChangeTracker` + ECS 重映射(`scene.ts:132-150`)可复用。调参体验从"重载丢状态"升级到"改字段立即生效"。
+
+> 注:编辑器源码在仓外,改契约需跨仓协调——这是 RC10 的主要约束,故契约设计须先行、向后兼容。
+
+---
+
+## RC11:网络复制 / 多人
+
+### 病灶
+- **复制层完全为零**:"replication" 概念全仓不存在;`net/GameSocket.ts` 仅有 socket 传输,无权威/插值/relevancy/RPC。
+
+### 目标架构
+- **从反射生成复制层(复用 RC9 + 已有 ptr 布局)**:基于 RC9 第 1 步的 `replicated`/`authority` 注解,从 EHT 生成 per-component 增量序列化器——**复用 `ptrLayouts.generated.ts`(本身已是紧凑二进制表示)做 binary diff**,与 RC9 第 2 步的 binary delta 序列化共享底层;运行时补权威/插值/relevancy。
+- **战略定位**:工作量最大;若产品路线图含多人则为战略缺口,否则暂缓。其杠杆点在于"反射注解 + ptr 布局"已铺好底座,不必从零造轮子。
+
+---
+
+## 附:工具链小改进(非引擎架构,顺手)
+
+- **收敛 8 套重复 flag 集合**:`Emscripten.cmake` 各 target 手工重复 link flags 易漂移 → 抽公共基集 + 差异叠加(`es_emscripten_flags()` 或 `list(APPEND)`),逐 target 验证产物字节级一致。低风险纯重构。
+- **EHT 去正则**:`parser.py` 正则解析 C++ 头对模板/宏脆弱 → 迁 libclang AST(保留 Python,只换解析内核)。
+- **wasm-split 懒加载**:对主 `esengine.wasm` 用 profile-guided `wasm-split`,把编辑器专用/post-process/tilemap 冷代码切二级模块,首屏只下主块;`ES_ENABLE_*` 特性开关天然是切分边界。微信/playable 首包体积 KPI。
+- **CMake generator 换 Ninja**(emsdk 已自带)。
+
+## 尊重的既定取舍(不改)
+
+经独立复核,以下决定正确,**本文不建议改动**:
+- `-fno-exceptions` + 显式状态码(保留,省体积/速度)。
+- Memory64(2D 引擎用不上 4GB 上限,纯 ~10-20% 性能/体积税)。
+- archetype(不如 owning-group,且冲突 RC2)。
+
+---
+
+## 执行顺序(按"微信/playable 主战场 + ROI"排,全程保持构建常绿,每批可独立验证)
+
+| 档位 | 批次 | 依据 |
+|---|---|---|
+| **立即(独立 / 低风险 / 见效快)** | RC7-1 实例化粒子、RC7-2 多纹理批、RC8-1 SIMD math、RC7-6 shader 死代码清理+统一来源、RC9-2 scene 迁移框架、工具链 flag 收敛 | 均不依赖大重构;微信端立竿见影;半成品已在仓者优先激活 |
+| **keystone(解锁后续)** | RC7-3 GfxDevice 抽象抬升、RC9-1 富反射元数据单一源 | 两个总闸门,WebGL2/基线下即有收益,各自解锁一整条上层 |
+| **中长期(依赖前置 + 平台权衡)** | RC7-4 WebGPU、RC8-2/4 自动并行 + wasm threads、RC11 网络复制、RC10-2 状态保留热重载、RC10-1 规范化协议 | 依赖 keystone 或受微信平台约束需回退共存 |
+
+> 依赖序:RC7-3 是 RC7-4 的唯一前置;RC9-1 是 RC9-3 / RC10 inspector / RC11 复制声明的共同前置;RC8-2 的真并行依赖 RC8-4;RC11 依赖 RC9-1 + RC9-2。
+> 核心判断:**先吃 RC7-1/7-2/8-1 三个低垂果实(天级、纯加法、微信直接受益),同时把 RC7-3 与 RC9-1 两个 keystone 立项。WebGPU 性感但不插队。**
+
+---
+
+## 验证机制(与 RC1 keystone 同精神:机制即根治成立的证明)
+
+- **RC7 渲染**:实例化前后**逐像素回归**(同场景渲染结果一致,仅 draw call/带宽下降);GfxDevice 抽象抬升用既有 `MockGfxDevice` harness 守护接口契约;多纹理批的合并正确性用 draw call 计数断言。
+- **RC8 SIMD/并行**:SIMD math 用标量/向量化**逐 bit 对拍**关键变换;自动并行的冲突图用"同冲突集系统永不并行"断言 + 确定性回放测试;`ptrLayouts` 重生成后由 ABI hash 握手 + `static_assert(offsetof)` 守门。
+- **RC9 反射**:富元数据**端到端往返**(注解 → `COMPONENT_META` → inspector 渲染);scene 迁移框架的幂等性 + "版本过新即拒绝" 测试(仿 `prefab/migrate.ts`)。
+- **RC10 协议**:`attachEditor` 版本协商测试;scene live-patch 的 diff→apply 与全量重载结果一致性对拍。
+- **RC11 网络**:复制序列化往返(编码→解码逐字段一致);权威/插值确定性测试。
+
+---
+
+## 需要拍板的架构岔路
+
+| 岔路 | 选项 A | 选项 B(推荐) |
+|---|---|---|
+| **渲染后端路线** | 直接上 WebGPU 双后端 | **先抬升 GfxDevice 抽象(RC7-3),WebGL2 下落地 UBO/PSO 收益;WebGPU 作为其后的加法层** |
+| **并行执行后端** | 立即引入 wasm threads | **先做单线程冲突分析 + 确定性(RC8-2),threads 作为受平台约束的加法层(RC8-4)** |
+| **固定组合查询优化** | 全量 archetype 重构 | **EnTT owning-group(增量交集连续布局,兼容 RC2 单一 SparseSet)** |
+| **scene 格式** | 维持美化 JSON | **保留 JSON 为可读源 + 加版本迁移框架(RC9-2);二进制/delta 作为发布期可选编码** |
+| **RC11 启动时机** | 与 RC9 并行立即做 | **待产品确认多人路线后启动;底座(RC9-1 注解 + ptr 布局)先于其就位** |
+
+---
+
+## 实现进度(living status)
+
+- **RC9-2(scene 序列化版本迁移框架):✅ 已落地(2026-06-19)**,作为编辑器 play 态隔离(`RC12_EDITOR_SEAM.md` E4-3)的前置先行:`scene.ts` 新增版本化、幂等、非变异的 `migrateSceneData`(读版本 + 过新即拒绝 + 盖版本),散落硬编码迁移收编,`loadSceneData` 不再变异输入,并以组件 codec 注册表解除 scene↔tilemap 耦合。全 SDK 套件 2161 passed。详见 RC12 living status。
+- **其余 RC7–RC11:📋 已立项(设计文档)**,尚未开始执行。
+- 建议首个执行批次:RC7-1(实例化粒子,半成品已在仓,纯加法,验证成本低)作为切入点,同步启动 RC7-3 / RC9-1 两个 keystone 的详细根治方案文档。
diff --git a/docs/REARCH_IMPLEMENTATION_AUDIT.md b/docs/REARCH_IMPLEMENTATION_AUDIT.md
new file mode 100644
index 000000000..a31e73a1f
--- /dev/null
+++ b/docs/REARCH_IMPLEMENTATION_AUDIT.md
@@ -0,0 +1,169 @@
+# Estella 实现质量债审计(Implementation Quality Audit)
+
+> 目标读者:引擎维护者 / AI 协作代理。
+> **与 RC 文档的区别**:`REARCHITECTURE.md`(RC1–RC5)、`FOUNDATION_CONSOLIDATION`、`RC6_ASSETS`、`REARCH_FRONTIER.md`(RC7–RC11)描述的是**主动识别的根因**与**新能力规划**;本文是对**已实现、正在运行的代码**的一次全面质量体检——找出"能跑、但实现得糙 / 有裂缝 / 有空腔 / 该重构"的债。
+> 方法:2026-06 四路并行只读审计(设计 / 完成度 / 性能 / 健壮性)+ 逐条行号核实 + 误报剔除。
+> **重要免责**:A 类多为审计**推断**的缺陷(已核实行号与逻辑,但**未运行复现**)。执行时应**先写复现/回归测试确认,再修**,不可凭本文盲改。
+> 已排除 RC1–RC11 全部已修复 / 已规划项,下列均为**其之外**的剩余债。
+
+---
+
+## 0. 核心诊断:三类债 + 一个放大器 + 一条贯穿线
+
+### 放大器(根因级):`ES_ASSERT` 在 release/WASM 下编译为空操作
+`core/Log.hpp:316` —— `ES_ASSERT` 在生产构建展开为 `((void)0)`。后果:所有"靠 assert 兜底"的边界 / 成员资格 / 大小 / 溢出检查,在**出货版本里全部消失**,坠入未检查的 fall-through。开发期 assert 拦住的,生产期就是 OOB 读 / abort / 静默损坏。**A 类多项的严重度由此抬高。**
+
+> 系统性修复建议:把"必须始终生效"的边界检查从 `ES_ASSERT` 剥离为独立的、release 也保留的运行时守卫(与 RC3 "边界校验始终开启" 同精神,但 RC3 只覆盖了 JS→C++ 的 embind 入口,**引擎内部调用点未覆盖**)。
+
+### 一条贯穿性能债的线:有机制却没接上用
+难的(SIMD / 并行 / 批合并)已在 RC7–RC8 规划;本审计发现的性能债集中在另一类——**dirty / 缓存 / 复用机制已存在,却没被调用**:`rebuildIfDirty()` 不调而走无条件 `rebuild`、`Shader::uniformCache_` 被绕过、`sort_entries_` 间接排序却又物化深拷贝、wasm 真值源之外又维护一份 JS Set。多为低-中风险、改动局部、收益直接。
+
+### 一类最危险的债:功能静默缺失(不是死代码,是"以为有其实没有")
+比死代码更危险——代码看似实现了某功能,但**从未接到运行路径**,用户/上层以为它在工作:活地图无碰撞体、UI 行为层不 tick、微信音量控制 no-op、material 缓存失效 no-op。见 B2。
+
+---
+
+## A. 正确性裂缝(会崩溃 / 内存损坏 / 资源泄漏)
+
+### A-Critical(确定的 abort / OOB / UAF,优先堵)
+
+| # | 位置 | 缺陷 | 触发 | 后果 | 修复 |
+|---|---|---|---|---|---|
+| A1 | `core/Log.hpp:244` | `std::stoi` 解析浮点格式精度,`-fno-exceptions` 下抛即 abort | 格式串以 `f` 结尾含 `.` 但精度段非数字/空,如 `"{:.f}"` | **整个 WASM 模块挂死** | 改 `std::from_chars`,失败跳过精度 |
+| A2 | `renderer/Texture.cpp:166-174` | `setDataRaw` 把 `sizeBytes` `(void)` 丢弃,按全尺寸 `texSubImage2D` | 调用方传入小于 `w*h*bpp` 的 buffer | **越界读 WASM 线性内存** | 运行时校验 `sizeBytes`,不足早退 |
+| A3 | `bindings/SpineModuleEntry.cpp:589,631+` | `currentBatch` 裸指针指入 `meshBatches` vector,后续 `emplace_back` 扩容搬迁后继续写 | 任意 ≥2 batch 的骨骼 | **use-after-free 写 / 堆破坏** | 改存 `batchIndex` 整型,用时重解析;或预 `reserve` |
+| A4 | `bindings/SpineModuleEntry.cpp:184,193` | `spSkeletonBinary/Json_create` 返回 null 未检查即解引用 | spine-c 分配失败 / 损坏数据 | null 解引用 UB | 解引用前判空,失败返回 -1 |
+| A5 | `text/BitmapFont.cpp:133,156` | `createLabelAtlas` 整数除零(`charWidth==0` 或 `texWidth<charWidth`) | 数据驱动的图集描述 | **WASM trap,模块 abort** | `cols==0 \|\| charWidth==0` 早退 |
+| A6 | `ecs/SparseSet.hpp:193`、`ecs/Registry.hpp` `get<T>` | release 下唯一守卫 `ES_ASSERT(contains)` 消失,`denseIndexOf` 返回 `0xFFFFFFFF` 被当下标 | 对不持有组件的实体 `get<T>`(`UILayoutSystem.cpp:72` 等 `get<UIRect>(parent)`) | **无界 OOB 读 → 静默损坏/崩溃**(引擎内最大 OOB 源) | `get` 走 release 也生效的范围检查;热路径用 `tryGet` |
+
+### A-High(生命周期 / 泄漏 / 静默损坏)
+
+- **A7 重入 `destroy` 计数下溢 + 索引双回收** `ecs/Registry.hpp:137-167`:`onDestroy` 内递归 destroy 同实体,内外层各 `--entity_count_`(usize 下溢)+ 同 idx 两次入 `recycled_` → 未来 create 发出别名 entity。修:回调前先标失效。
+- **A8 `View<T>::each` 单组件特化不快照** `ecs/View.hpp:421-437`:持 `pool_->entities()` 引用,回调内 emplace 扩容即悬垂 / remove swap-pop 漏访。多组件版有快照,单版没有,**行为不一致**。修:单版同样快照 + 复检。
+- **A9 层级递归无深度/环守卫** `TransformSystem.hpp`(`destroyWithChildren:223`/`isDescendantOf:151`/`getRoot:214`)、`UITree::buildDFS`:裸 `emplace<Parent>` 可造环 → 无限递归 / 栈溢出 trap。修:深度上限 + visited 集。
+- **A10 `ResourceManager` 所有 create* 裸解引用 `*device_`** `resource/ResourceManager.cpp:63,127,274`:init 前 / shutdown 后调用 → null 解引用或 UAF。修:`!initialized_` 早退,shutdown 置 `device_=nullptr`。
+- **A11 Spine 资源生命周期**:`texture_handles_` 按去重后 handle id 作 key → 共享条目被提前/双重释放(`SpineResourceManager.cpp`);`loadJson/loadBinary` 成功但 `pool_.get==null` 时局部 atlas 析构却仍缓存 → 渲染时 UAF。
+- **A12 `ParticleSystem` 注册捕获 `this` 的 onDestroy 永不移除** `particle/ParticleSystem.cpp:12-17`:系统先于 Registry 析构后回调悬垂 this。修:析构 `removeOnDestroy`。
+- **A13 Physics 关节生命周期** `bindings/PhysicsJoints.cpp:35,144`:`entityToJoint[B]` 单端 key → 同 B 再建关节旧句柄泄漏;destroy body A 留悬垂 map 条目。
+- **A14 Tilemap 越界 / 截断**:`setChunkTiles` 源索引用未裁剪 `width`(`TilemapSystem.cpp:92`)OOB 读;`convertGid` 双重截断把大 gid 静默映射成错 tile(`TiledMapLoader.cpp:114`);Tiled 有符号 count 未检查(`:197`)负转 u32 巨大 → bad_alloc/OOB。
+- **A15 渲染器错误契约形同虚设** `Texture.cpp:131`:`initialize()` 恒返回 true,失败路径死代码,OOM 时返回包裹 id 0 的"有效"纹理(静默黑屏);`createFromExternalId` 析构无条件 `deleteTexture`(外部所有者也删 → 双删);`CustomGeometry::init` 空 layout `stride_==0` 除零。
+- **A16 TS:WASM 实例化失败吞掉** `wechatRuntime.ts:89`、`spine/SpineModuleLoader.ts:190`:`.catch` 只 log 不调 `successCallback` → **工厂 Promise 永久挂起**,该路径所有调用挂死。修:透传 rejection + 超时。
+- **A17 TS:超时纹理仍上传 → 每次慢加载泄漏 VRAM** `asset/AsyncCache.ts:41`:超时置 `aborted` 但底层继续跑、返回已注册 GL 的纹理被丢弃无人释放。修:`onAbandon` 处置器 / AbortController。
+- **A18 TS:Scene `load/unload` 无回滚** `sceneManager.ts:280-391`:load 失败留 `status==='loading'` 尸体,重试解引用 undefined → **场景永久无法重载**;`unload` 的 `config.cleanup` 无 try/catch,抛出则后续 teardown 全跳过 → entity/system/纹理泄漏。
+- **A19 TS:Physics/Spine Plugin 无 `cleanup()`** :native 模块 shutdown 是死代码,`world.onDespawn` 监听注册不移除 → re-init 留陈旧监听。
+- **A20 TS:`createTexture()!` 上下文丢失崩 + 错误路径 GL 泄漏** `TextureLoader.ts:188`、`compressed.ts:168`:`!` 断言 null;upload 抛出则纹理不删。
+- **A21 TS:Audio 多处** :`Audio.ts:98` 快速换 BGM 不 stop 旧 handle → 永放泄漏;`AudioPool.ts:52` release 不 disconnect → 音频图累积。
+
+### A-Medium(规模相关 / 静默别名,择要)
+- `ResourcePool`/`Registry` 的 index+generation 打包静默溢出(>2^20 条目或槽复用 4096 次后 handle 别名);`clear()` 把 generation 重置为 0 → reinit 后旧 handle 与新资源别名误判 `valid()`。
+- `PhysicsContext.cpp:24` entity 0 存为 `void*(0)` 被当"无 userdata" → entity 0 碰撞/射线静默丢弃(修:存 `id+1`)。
+- Box2D create 返回值从不校验、多边形/链顶点无上界校验(bad_alloc abort);`getEventRecord(i32)` 无界索引 OOB。
+
+> 已核实为**非问题**(避免误修):`TilemapRenderPlugin.cpp:177` 在 `const auto&` 上写 `dirty` 是有意的 `mutable` 渲染缓存(`ChunkData::dirty` 声明 mutable + collect 非 const),**不是 const 违规**;Texture/Buffer/Shader 的 move 语义干净、shader 编译失败路径正确清理、Framebuffer 完整性检查在位。
+
+---
+
+## B. 空腔(死代码 + 半成品)
+
+### B1:可直接删的死代码(低风险,缩小地基面积)
+
+**C++ 整块死岛**(无 embind 暴露,删除干净):
+- `platform/` 抽象岛:`Platform`/`WebPlatform`(`Platform::create` 零调用 → 从不构造,20 虚函数全死)、`Input` 类、`PathResolver` 全套、`FileSystem` 16 个方法死 15(仅 `readBinaryFile` 被 `SpineExtension.cpp:27` 用,保留)。宣传的热重载/文件监视从未实现。
+- `resource/` 死面:可插拔 loader 子系统(`ResourceLoader.hpp` + `LoaderRegistry.hpp` + `ResourceManager::registerLoader/getLoader/...` + `loaderRegistry_`,无任何子类)、`Resource.hpp`(零 include)、GUID 纹理缓存(`loadTextureByGUID/...` + `guidToTexture_`)、VBO/IBO 工厂、`ResourceStats`、`SharedHandle` + 三别名。
+- `core/Engine.hpp`+`.cpp` 整个 `Engine`/`EngineVersion`(编译但从不实例化,仅文档引用)、`Types.hpp:263` `Result<T,E>`、`RuntimeConfig` 热重载残留、`Math.hpp` 死函数(`lookAt`/`eulerToQuat`/`quatToEuler` 等,quat 在 TS 侧做)。
+
+**渲染死项**:6 个死 `.esshader`(axis/color/gizmo/grid/sprite/ui,运行时只用 batch+shape)+ 对应 `ShaderEmbeds.generated.hpp` 条目、`Shader.hpp` 的 `EXT_MESH_*` ES1.0 遗留、`renderer/TextureSlotAllocator.hpp` 整文件、`RenderContext` stats 链、一组零调用 getter(`Framebuffer::getSpecification`、`RenderTarget::getSize`、`TransientBufferPool::vboId` + 永不产出的 `LayoutId::MatSprite`)、`GfxEnums.hpp` 死枚举值。
+
+**ECS / 动画死项**:5 个未用 tag 组件(`Common.hpp` `Active/Visible/Static/MainEntity/Folder`)、`Script.hpp` 整文件 + ScriptComponent 集群(TS 用自己的 ScriptStorage)、`Registry::restore/sort<T>`、`View::getAll`、`Glyph::page`(write-only)、`TweenData::group_id`。
+
+**~28 个死 embind 绑定**(JS 零调用,仅 `wasm.ts` 声明):`renderFrame`/`renderFrameWithMatrix`(旧整体入口)、6 个空 `renderer_submitXxx` stub、12 个 Tiled object-group 绑定(`tiled_getObjectGroupCount/...`,TS 走纯 JS `parseTmjJson`)+ 连带 C++ `TiledObjectInfo` 结构、postprocess 6 个、resource refcount getter、UI patch/dirty/anim-override 一组、`physics_hasBody/hasJoint`。**删前确认 clip/stencil 8 个不是给外部 embedder 的公开 API。**
+
+**Python / Node / CMake 死项**:`type_system.py` 的 `needs_wrapper` 被同名第二定义**整个遮蔽**(第一个永不执行)+ `is_glm/is_custom_struct` 零调用;Node 死导出(`buildAllWasm`/`buildSdkDirect`/`syncWasmOnly`/logger spinner 全套/`hash.js` 部分/`errorHelp BuildError`);`Emscripten.cmake:149` `es_apply_emscripten_settings()` 死簇(导出的 `_es_app_init` 无定义,pre-SDK 遗留);孤儿且**损坏**的 `tools/bundle-playable.js`(CommonJS require 但 root 是 ESM,一跑就崩);`tools/pack_bitmap_font.py` 零 wiring。
+
+**整目录决策项**:`src/esengine/events/` 仅被 `tests/events/test_events.cpp` 消费,引擎/SDK/示例零集成(含纯死的 `ScopedConnection`、`Signal` 非 void 特化 ~115 行)。**若不打算发布事件系统,整目录是删除候选。**
+
+### B2:功能静默缺失(必须**接线或明确移除**——需产品决策)
+
+| # | 位置 | 现象 | 影响 |
+|---|---|---|---|
+| **B2-1** | `tilemap/tiledLoader.ts` `generateTileCollision:544` / `collisionMerge.ts` | 只被测试调用;生产路径 `parseTmjJson→tilemapPlugin` 上传 tile 但**不生成任何 collider** | **活的瓦片地图静默无碰撞**(正确性) |
+| **B2-2** | `ui/plugin.ts:25` `uiBehaviorPlugin` | barrel 导出但不在 `uiPlugins.ts` 的 11 插件中 → 任何 `createWebApp` 应用里**整个 Layer-2 UI 行为层(ListView/StateMachine/滚轮)永不 tick** | 整层功能死 |
+| **B2-3** | `platform/wechat/WeChatAudioBackend.ts:95` | `mixer` 返回 null(Web 返真 AudioMixer) | 微信平台 `setMusicVolume/SFXVolume/UIVolume/master` **静默 no-op** |
+| **B2-4** | C++ MaterialCache 链 | `getMaterialDataWithUniforms` 零调用 = 唯一写 `material_cache` 者 → `EngineState::material_cache` 永空 | TS 侧 `invalidateMaterialCache/clearMaterialCache`(`material.ts:200-281`)沦为**对永空 map 的 no-op** |
+| **B2-5** | `resource/ShaderParser` `remapCompilerLog`/`assembleStageEx` | 完整的错误行号重映射功能从未接入编译错误路径(活的 `assembleStage` 丢弃 `headerLineCount`) | shader 报错行号不准(最高价值"待接线"项) |
+| **B2-6** | `PostProcess volumeSystem.ts:91` | 只激活 `isGlobal` 体积(硬编码 factor:1),非全局体积取出即丢 | 空间体积混合运行时全死 |
+| **B2-7** | Timeline `MarkerTrack` / `CustomEventTrack` | TimelineLoader 解析但 Uploader 无 upload case | "timeline 触发游戏事件"未完成,静默丢弃 |
+| **B2-8** | `core/Log.hpp` sink 子系统 | `addSink/removeSink` 零调用,`sinks_` 恒空,`notifySinks()` 每条日志空转 | 日志无法重定向 |
+
+其它半成品:Spine asset-loader controller 路径从未武装(`setSpineController` 无人调用,`getSkeletonHandle` 恒 -1)、`uiBehavior` 的 `uiFlexLayout_update` 空 stub、prefab diff 无法发 `entity_removed`、audio `priority`(voice-stealing 搭架未实现)。
+
+### B3:配置 / 构建死项与不一致
+- **`build.config.js:15-19` optimization 只覆盖 15 个 wasm 目标中的 3 个**,其余 12 个(含本应 `-Oz` 的 `physics-playable`)静默拿默认 `-O2`。**发布意外优化级别。**
+- 优化级别**三处规定且互相冲突**:`build.config.js`(编译 -O2/-Oz)vs `Emscripten.cmake`(链接硬编码 -O3)vs `wasm.js:144`(wasm-opt)——无单一真源。
+- `CMakeLists.txt:224` `GENERATED_EDITOR_API` 缺于 eht custom_command 的 OUTPUT/DEPENDS(潜在增量构建陈旧);toolchain CLI `--no-strip/--no-archive`/`--debug` 被忽略/中和;`tasks/sdk.js` SDK 文件列表声明两次会漂移;`field_utils.py VEC*_SUBS` 与 `anim_target.py` 重复。
+
+---
+
+## C. 性能债(热路径低效)
+
+### C-Critical:每帧整体重算,有现成 dirty 机制却被绕过
+- **C1 UI 布局树每帧无条件全量重建** `ecs/UILayoutSystem.cpp:421` → `UITree.hpp:28`:`layoutUpdate` 每帧 `tree.rebuild()` 重走整棵 Canvas 层级,**而 `rebuildIfDirty()` + `structure_dirty_` 已存在、JS 导出已接好**(`WebSDKEntry.cpp:550`),紧随的 `unifiedLayoutPass` 本身已 dirty 门控、被白白浪费。修:改调 `rebuildIfDirty`(近一行)。风险中:先审所有 add/remove/reparent 是否都 mark dirty。
+- **C2 `UITree::indexOf` O(n) 被 `markDirty` 沿祖先链反复调** `UITree.hpp:65`:单次 markDirty O(depth×n),批量 mark 退化每帧 O(nodes²)。修:rebuild 时建 `Entity→index` 表,O(1)。
+- **C3 UI render-order 每帧全量 DFS 重算** `UIRenderOrderSystem.hpp:38`:无 dirty 门控,结构不变也算同样的值。修:复用 C1 的 structure-dirty 信号。
+
+### C-High
+- **C4 DrawList 每帧整表深拷贝排序缓冲** `DrawList.cpp:35-40`:每帧堆分配全量 `std::vector<DrawCommand>`(~96B/条 ×数千)+ 乱序深拷贝每条 + 释放旧。`sort_entries_` 间接排序本为避免物化,这里又物化了。修:`sorted` 提升为常驻 scratch 或就地按序合并。
+- **C5 每帧字符串查 uniform location** `DrawList.cpp:70`:draw 循环里 `getUniformLocation(shader, "u_projection")` 字符串键查找 + 跨界,且 `u_projection` 整帧恒定却每次 shader 切换重 set;`Shader::uniformCache_` 被绕过。修:每 program 缓存 location,每帧 set 一次。
+- **C6 粒子 `forEachAlive` 扫满池容量 + `std::function` 间接调用** `particle/Particle.cpp:55`:容量 10000/存活 50 仍跑 10000 次。修:packed swap-remove 迭代 `[0,alive)` + 模板函子。风险中(现用索引算术,需协同改)。
+- **C7 SpineController 每帧每批拷贝两个 typed array + 对象字面量** `spine/SpineController.ts:224-271`:`new Float32Array(vertices)` + `new Uint16Array(indices)` 每实例每批每帧 → 动画 Spine 主 GC 源。修:池化 scratch / 直接暴露 heap view 上传。
+- **C8 BuiltinBridge 冗余 JS `Set<Entity>` 镜像** `ecs/BuiltinBridge.ts:303`:每内置组件成员关系在 C++ 和 JS Set 各一份;`deleteFromEntitySets` 每次 despawn O(组件类型数) 全扫。**约束:query 规划器的 smallest-set 收窄依赖它的 `.size`,不能直接删**。修:让 delete 只动该实体实际所在的 set。
+
+### C-Medium / 快速 win(一行 / 低风险类)
+- **M2 `packColor` 在 4 顶点循环内重复算** `SpritePlugin.cpp:138`、`UIElementPlugin.cpp:140`:提到循环外,**一行、零风险**(nine-slice/text 路径已正确提外,基础四边形漏了)。
+- 文本 collect 每帧走 3 遍字符串 + 逐字符 hash(`TextPlugin.cpp:71,90,121`,`measureText` 已返回宽度可复用);`TimelineRuntime.ts:185` per-property 循环内 `.filter` O(n²) + 每帧数组;`PhysicsSystem.ts:410` 每帧 4 数组 + 每事件字面量 + 空资源对象;UI behavior 模板字符串键 slot 查找 + 每帧 Color/scale 字面量;`world.ts` 多处(空查询不缓存、每帧重建 depIds、`getComponentTypes` 线性扫 + `has()` 风暴);`ChangeTracker` 连 `isEmpty` 都分配数组;`L2 RenderFrameSubmit.cpp:86` Spine 索引重映射每批堆分配。
+
+> 已核实为**干净**(无需动):`TransformSystem`(正确 dirty 跳过干净子树)、`StateTracker`(模范去重 early-return)、`TransientBufferPool`(缓冲复用非每帧重建)、`QueryCache` hit 路径零分配、`ptrAccessors`(写预分配 out + 每实体重读 HEAP 是 `ALLOW_MEMORY_GROWTH` 下的**必要**正确性)。
+
+---
+
+## D. 结构债(设计层,大重构)
+
+### D-High
+- **D1 entity/handle 位打包逻辑三处独立复制**:`core/Types.hpp:128`(Entity 20+12 位)、`resource/Handle.hpp:52`(逐字复制)、`ecs/Entity.hpp:5`(FFI 64-bit 第三套)。扩世界容量要三处同步改,漏改即句柄碰撞。修:抽 `PackedId<INDEX_BITS,GEN_BITS>` 模板委托。**非 TypeId 排除项**(那是类型身份,这是实例索引+代际)。
+- **D2 `ResourceManager` 五类资源样板各一套 + Texture 独挂 GUID 层** `resource/ResourceManager.hpp:131-357`:违反 SRP,四套独立 pool 的 find/add/release 重复,Texture 释放耦合元数据/GUID。修:`TypedResourcePool<T>` 模板 + `TextureMetadataRegistry` 下沉。**RC6 资产管线会建在其上,先收口收益大。**
+- **D3 `world.ts` 770 行 god class + 组件操作双路由**:实体生命周期 + 层级 + builtin/script 路由 + 查询缓存全塞一类,`isBuiltinComponent` 分支在 insert/set/get/has/remove/tryGet 出现 14+ 次。修:拆 `EntityManager`/`HierarchyManager`/`ComponentDispatcher`/`QueryEngine`。
+- **D4 SceneManager / App 两套实体销毁路径** `sceneManager.ts:356` vs `app.ts:539`:销毁/卸载决策分散两处,SceneManager 本应只管配置却直接操纵 world。修:抽 `SceneOrchestrator` 统一实体生命周期。
+- **D5 UI 三 plugin 各自重造 Entity→资源缓存 + 清理循环** `TextPlugin.ts:31`、`ImagePlugin.ts:22`、`TextInputPlugin.ts:49`:同模式三份,驱逐策略不一致;`TextRenderer.ts:47` 文本缓存无上界(长时游戏 OOM)。修:抽 `EntityResourceCache<T>`(acquire/release + valid 驱逐 + LRU 上界)。
+
+### D-Medium(择要)
+- 四边形索引绕序两套不一致(4 plugin `{0,1,2,2,3,0}` vs ParticlePlugin `{0,1,2,0,2,3}`)+ QUAD 常量 5 处复制 → 抽 `QuadPrimitive.hpp`。
+- Registry 手搓重入守卫(`firing_destroy_` + dead 标志)与 `events/Signal.hpp` 成熟的 `publishing_` + RAII Connection 重复 → Registry 复用 Signal。
+- WASM `_malloc`/HEAP 视图/`ptr>>2` 散在 draw/geometry/material 各自管理 + `PTR_LAYOUTS` 误入公共导出 → 抽 `WasmScratch`,内部化布局。
+- `RenderFrame` 编排过载(10+ 不相干成员,clip 与 ClipState 双层维护,stencil 内部结构体泄漏进接口);`BuiltinBridge` 五职责混杂;`UISystem` 公有可变成员破坏封装;C++ 缺字符串工具层(trim 双实现)。
+
+---
+
+## 执行优先级(建议分档,全程保持构建常绿、每项独立验证)
+
+| 档 | 内容 | 理由 |
+|---|---|---|
+| **1. 堵裂缝(先做)** | A1/A2/A5(单点消除确定 abort/OOB)→ A6/A7/A8/A9(ECS 核心 OOB/UAF/下溢,`ES_ASSERT` strip 暴露面最广)→ A3/A4/A11/A12(Spine/Particle UAF)→ A16/A17/A18(TS 挂死/泄漏/场景 wedge) | 真 bug,独立、多为小改动,**每项先写回归测试**。建议同时做"边界检查 release 生效"的系统性修复 |
+| **2. 删死代码(低风险)** | B1:platform/ 死岛、resource/ 死面整块删;6 死 shader、Engine、Script.hpp、~28 死绑定、Python/Node 死项 | 缩小地基面积,让后续重构更清晰,零行为变化 |
+| **3. 决策半成品(需拍板)** | B2:Tilemap 碰撞、UI 行为层、微信 audio mixer、MaterialCache 链、ShaderParser 报错重映射——逐个"接线 or 移除" | 功能静默缺失,**产品决策**:要这功能就接线,不要就删(别留半成品) |
+| **4. 性能快速 win** | C1(一行 rebuildIfDirty)、M2(一行 packColor)、C5(缓存 uniform location)、C2/C4 → C6/C7 | 低风险、改动局部、收益直接;"有机制没用上"类 |
+| **5. 大重构立项** | D1(位打包统一,RC6 前)、D2(ResourceManager 模板化,RC6 前)→ D3/D4(World/Scene 拆分)→ D5(UI 缓存) | 影响演进,工作量大,作为新 RC 排期 |
+
+---
+
+## 验证机制
+- **A 类**:每个缺陷**先写复现/回归测试**(触发条件 → 期望不崩/不泄漏),红→绿后再清单标记修复。优先用 header-only / MockGfxDevice harness(RC1–RC6 已验证可本机原生编译验证)覆盖 ECS/资源/渲染内部。
+- **B1 删除**:删后全量构建 + 全测试套件常绿(零行为变化即证明确为死代码);embind 删除额外 grep `wasm.ts` 确认无声明残留。
+- **B2 接线**:接线项补"功能确实运行"的集成测试(活地图有 collider、UI 行为层 tick、微信 audio mixer 真改音量)。
+- **C 类**:性能项配 before/after 计数断言(draw call 数、每帧分配数、迭代次数),避免回归。
+- **D 类**:大重构每批保持外部行为不变,用既有测试套件 + 新增结构测试守门。
+
+---
+
+## 实现进度(living status)
+- 📋 全部已立项,未开始执行。
+- 建议首批:A1/A2/A5(确定 abort/OOB,最小改动最高确定性)+ B1 的 platform/resource 死岛删除(低风险、立即缩小面积)。
diff --git a/examples/audio-demo/.esengine/settings.json b/examples/audio-demo/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/audio-demo/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/audio-demo/project.esproject b/examples/audio-demo/project.esproject
index d08fe5339..42112a7a6 100644
--- a/examples/audio-demo/project.esproject
+++ b/examples/audio-demo/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "Audio Demo",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/collision-layers/.esengine/settings.json b/examples/collision-layers/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/collision-layers/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/collision-layers/project.esproject b/examples/collision-layers/project.esproject
index 4e0e78c9a..f303ddc39 100644
--- a/examples/collision-layers/project.esproject
+++ b/examples/collision-layers/project.esproject
@@ -1,14 +1,11 @@
{
+ "formatVersion": "1",
"name": "Collision Layers",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "enablePhysics": true,
- "physicsGravityX": 0,
- "physicsGravityY": -9.8,
- "collisionLayerNames": ["Red", "Green", "Blue"],
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/ecs-basics/.esengine/settings.json b/examples/ecs-basics/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/ecs-basics/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/ecs-basics/project.esproject b/examples/ecs-basics/project.esproject
index c91f9a09b..6c583f900 100644
--- a/examples/ecs-basics/project.esproject
+++ b/examples/ecs-basics/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "ECS Basics",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/event-system/.esengine/settings.json b/examples/event-system/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/event-system/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/event-system/project.esproject b/examples/event-system/project.esproject
index 3ebf05993..581016c0f 100644
--- a/examples/event-system/project.esproject
+++ b/examples/event-system/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "Event System",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/hello-world/.esengine/settings.json b/examples/hello-world/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/hello-world/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/hello-world/project.esproject b/examples/hello-world/project.esproject
index 49afe581e..740b64d99 100644
--- a/examples/hello-world/project.esproject
+++ b/examples/hello-world/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "Hello World",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/input-demo/.esengine/settings.json b/examples/input-demo/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/input-demo/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/input-demo/project.esproject b/examples/input-demo/project.esproject
index e17d10aa1..98418896e 100644
--- a/examples/input-demo/project.esproject
+++ b/examples/input-demo/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "Input Demo",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/particle-demo/.esengine/settings.json b/examples/particle-demo/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/particle-demo/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/particle-demo/project.esproject b/examples/particle-demo/project.esproject
index bdb9e661a..c1d861c7d 100644
--- a/examples/particle-demo/project.esproject
+++ b/examples/particle-demo/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "Particle Effects",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/physics-playground/.esengine/settings.json b/examples/physics-playground/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/physics-playground/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/physics-playground/project.esproject b/examples/physics-playground/project.esproject
index 71be39381..fa0e5221d 100644
--- a/examples/physics-playground/project.esproject
+++ b/examples/physics-playground/project.esproject
@@ -1,13 +1,16 @@
{
+ "formatVersion": "1",
"name": "Physics Playground",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
"spineVersion": "none",
- "enablePhysics": true,
- "physicsGravityX": 0,
- "physicsGravityY": -9.8,
- "designResolution": { "width": 800, "height": 600 }
+ "features": {
+ "physics": {
+ "enabled": true
+ }
+ }
}
diff --git a/examples/physics-spinner/.esengine/settings.json b/examples/physics-spinner/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/physics-spinner/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/physics-spinner/project.esproject b/examples/physics-spinner/project.esproject
index c351d7aee..95f81b923 100644
--- a/examples/physics-spinner/project.esproject
+++ b/examples/physics-spinner/project.esproject
@@ -1,13 +1,16 @@
{
+ "formatVersion": "1",
"name": "Physics Spinner",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-03T00:00:00.000Z",
- "modified": "2026-03-03T00:00:00.000Z",
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
"spineVersion": "none",
- "enablePhysics": true,
- "physicsGravityX": 0,
- "physicsGravityY": -9.81,
- "designResolution": { "width": 800, "height": 600 }
+ "features": {
+ "physics": {
+ "enabled": true
+ }
+ }
}
diff --git a/examples/platformer/.esengine/settings.json b/examples/platformer/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/platformer/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/platformer/project.esproject b/examples/platformer/project.esproject
index 82470bc32..c31d3dcd8 100644
--- a/examples/platformer/project.esproject
+++ b/examples/platformer/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "Platformer",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/postprocess-effects/.esengine/settings.json b/examples/postprocess-effects/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/postprocess-effects/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/postprocess-effects/project.esproject b/examples/postprocess-effects/project.esproject
index 894a9aef5..1202742fe 100644
--- a/examples/postprocess-effects/project.esproject
+++ b/examples/postprocess-effects/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "Post-Processing",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/space-shooter/.esengine/settings.json b/examples/space-shooter/.esengine/settings.json
deleted file mode 100644
index 49baf3816..000000000
--- a/examples/space-shooter/.esengine/settings.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
- "lastOpenedScene": "assets/scenes/main.esscene"
-}
diff --git a/examples/space-shooter/project.esproject b/examples/space-shooter/project.esproject
index 0dfb09eab..f244aa526 100644
--- a/examples/space-shooter/project.esproject
+++ b/examples/space-shooter/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "Space Shooter",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-02-26T00:00:00.000Z",
- "modified": "2026-02-26T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 600, "height": 1080 }
+ "designResolution": {
+ "width": 600,
+ "height": 1080
+ },
+ "spineVersion": "none"
}
diff --git a/examples/sprite-animation/.esengine/settings.json b/examples/sprite-animation/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/sprite-animation/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/sprite-animation/project.esproject b/examples/sprite-animation/project.esproject
index 774c6e91c..3020a17d6 100644
--- a/examples/sprite-animation/project.esproject
+++ b/examples/sprite-animation/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "Sprite Animation",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/sprite-rendering/.esengine/settings.json b/examples/sprite-rendering/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/sprite-rendering/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/sprite-rendering/project.esproject b/examples/sprite-rendering/project.esproject
index 97d7a18d9..1d28abb67 100644
--- a/examples/sprite-rendering/project.esproject
+++ b/examples/sprite-rendering/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "Sprite Rendering",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/tween-animation/.esengine/settings.json b/examples/tween-animation/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/tween-animation/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/tween-animation/project.esproject b/examples/tween-animation/project.esproject
index 12b24912d..22b5d4af2 100644
--- a/examples/tween-animation/project.esproject
+++ b/examples/tween-animation/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "Tween Animation",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/ui-controls/.esengine/settings.json b/examples/ui-controls/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/ui-controls/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/ui-controls/project.esproject b/examples/ui-controls/project.esproject
index 838db3947..0bbe0a4ad 100644
--- a/examples/ui-controls/project.esproject
+++ b/examples/ui-controls/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "UI Controls",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/ui-interaction/.esengine/settings.json b/examples/ui-interaction/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/ui-interaction/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/ui-interaction/project.esproject b/examples/ui-interaction/project.esproject
index c5d8a6a0a..f1d6bca70 100644
--- a/examples/ui-interaction/project.esproject
+++ b/examples/ui-interaction/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "UI Interaction",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/examples/ui-layout/.esengine/settings.json b/examples/ui-layout/.esengine/settings.json
deleted file mode 100644
index 4ae0a6dc7..000000000
--- a/examples/ui-layout/.esengine/settings.json
+++ /dev/null
@@ -1 +0,0 @@
-{ "lastOpenedScene": "assets/scenes/main.esscene" }
diff --git a/examples/ui-layout/project.esproject b/examples/ui-layout/project.esproject
index ebf110fc4..39258e199 100644
--- a/examples/ui-layout/project.esproject
+++ b/examples/ui-layout/project.esproject
@@ -1,10 +1,11 @@
{
+ "formatVersion": "1",
"name": "UI Layout",
"version": "0.1.0",
- "engine": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
- "created": "2026-03-02T00:00:00.000Z",
- "modified": "2026-03-02T00:00:00.000Z",
- "spineVersion": "none",
- "designResolution": { "width": 800, "height": 600 }
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index a2980a5c8..bcffb5c6a 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -21,6 +21,70 @@ importers:
specifier: ^8.0.0
version: 8.2.0
+ desktop:
+ dependencies:
+ '@modelcontextprotocol/sdk':
+ specifier: ^1.29.0
+ version: 1.29.0([email protected])
+ dockview:
+ specifier: ^6.6.1
+ version: 6.6.1([email protected])
+ esbuild:
+ specifier: ^0.27.0
+ version: 0.27.7
+ esengine:
+ specifier: workspace:*
+ version: link:../sdk
+ lucide-react:
+ specifier: ^1.21.0
+ version: 1.21.0([email protected])
+ react:
+ specifier: ^19.2.0
+ version: 19.2.7
+ react-dom:
+ specifier: ^19.2.0
+ version: 19.2.7([email protected])
+ zustand:
+ specifier: ^5.0.14
+ version: 5.0.14(@types/[email protected])([email protected])
+ devDependencies:
+ '@fontsource/inter':
+ specifier: ^5.2.8
+ version: 5.2.8
+ '@fontsource/jetbrains-mono':
+ specifier: ^5.2.8
+ version: 5.2.8
+ '@types/node':
+ specifier: ^25.9.3
+ version: 25.9.3
+ '@types/react':
+ specifier: ^19.2.0
+ version: 19.2.17
+ '@types/react-dom':
+ specifier: ^19.2.0
+ version: 19.2.3(@types/[email protected])
+ '@vitejs/plugin-react':
+ specifier: ^6.0.2
+ electron:
+ specifier: ^42.4.1
+ version: 42.4.1
+ typescript:
+ specifier: ^6.0.3
+ version: 6.0.3
+ vite:
+ specifier: ^8.0.16
+ vite-plugin-electron:
+ specifier: ^1.0.4
+ version: 1.0.4([email protected])
+ vite-plugin-electron-renderer:
+ specifier: ^1.0.0
+ version: 1.0.0
+ vitest:
+ specifier: ^2.1.0
+
sdk:
devDependencies:
'@rollup/plugin-terser':
@@ -58,7 +122,7 @@ importers:
version: 5.9.3
vitest:
specifier: ^2.1.0
packages:
@@ -121,144 +185,329 @@ packages:
resolution: {integrity: sha512-Vd/9EVDiu6PPJt9yAh6roZP6El1xHrdvIVGjyBsHR0RYwNHgL7FJPyIIW4fANJNG6FtyZfvlRPpFI4ZM/lubvw==}
engines: {node: '>=18'}
+ '@electron-internal/[email protected]':
+ resolution: {integrity: sha512-OjKpjB7gohtEjZiq6nDx1egqjZJhGPN1iFOIED+NFhB/MMkXw/XRcHjh1DGXKT5z2W9eW7Jy2UKU3gpjvusFTQ==}
+ engines: {node: '>=22.12.0'}
+
+ '@electron/[email protected]':
+ resolution: {integrity: sha512-pjoBpru1KdEtcExBnuHAP1cAc/5faoedw0hzJkL3o4/IJp7HNF1+fbrdxT3gMYRX2oJfvnA/WXeCTVQpYYxyJA==}
+ engines: {node: '>=22.12.0'}
+
+ '@emnapi/[email protected]':
+ resolution: {integrity: sha512-yq6OkJ4p82CAfPl0u9mQebQHKPJkY7WrIuk205cTYnYe+k2Z8YBh11FrbRG/H6ihirqcacOgl2BIO8oyMQLeXw==}
+
+ '@emnapi/[email protected]':
+ resolution: {integrity: sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==}
+
+ '@emnapi/[email protected]':
+ resolution: {integrity: sha512-uTII7OYF+/Mes/MrcIOYp5yOtSMLBWSIoLPpcgwipoiKbli6k322tcoFsxoIIxPDqW01SQGAgko4EzZi2BNv2w==}
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==}
engines: {node: '>=12'}
cpu: [ppc64]
os: [aix]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-EKX3Qwmhz1eMdEJokhALr0YiD0lhQNwDqkPYyPhiSwKrh7/4KRjQc04sZ8db+5DVVnZ1LmbNDI1uAMPEUBnQPg==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [aix]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==}
engines: {node: '>=12'}
cpu: [arm64]
os: [android]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-62dPZHpIXzvChfvfLJow3q5dDtiNMkwiRzPylSCfriLvZeq0a1bWChrGx/BbUbPwOrsWKMn8idSllklzBy+dgQ==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [android]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==}
engines: {node: '>=12'}
cpu: [arm]
os: [android]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-jbPXvB4Yj2yBV7HUfE2KHe4GJX51QplCN1pGbYjvsyCZbQmies29EoJbkEc+vYuU5o45AfQn37vZlyXy4YJ8RQ==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [android]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==}
engines: {node: '>=12'}
cpu: [x64]
os: [android]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-x5VpMODneVDb70PYV2VQOmIUUiBtY3D3mPBG8NxVk5CogneYhkR7MmM3yR/uMdITLrC1ml/NV1rj4bMJuy9MCg==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [android]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==}
engines: {node: '>=12'}
cpu: [arm64]
os: [darwin]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-5lckdqeuBPlKUwvoCXIgI2D9/ABmPq3Rdp7IfL70393YgaASt7tbju3Ac+ePVi3KDH6N2RqePfHnXkaDtY9fkw==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [darwin]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==}
engines: {node: '>=12'}
cpu: [x64]
os: [darwin]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-rYnXrKcXuT7Z+WL5K980jVFdvVKhCHhUwid+dDYQpH+qu+TefcomiMAJpIiC2EM3Rjtq0sO3StMV/+3w3MyyqQ==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [darwin]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==}
engines: {node: '>=12'}
cpu: [arm64]
os: [freebsd]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-B48PqeCsEgOtzME2GbNM2roU29AMTuOIN91dsMO30t+Ydis3z/3Ngoj5hhnsOSSwNzS+6JppqWsuhTp6E82l2w==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [freebsd]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==}
engines: {node: '>=12'}
cpu: [x64]
os: [freebsd]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-jOBDK5XEjA4m5IJK3bpAQF9/Lelu/Z9ZcdhTRLf4cajlB+8VEhFFRjWgfy3M1O4rO2GQ/b2dLwCUGpiF/eATNQ==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [freebsd]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==}
engines: {node: '>=12'}
cpu: [arm64]
os: [linux]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-RZPHBoxXuNnPQO9rvjh5jdkRmVizktkT7TCDkDmQ0W2SwHInKCAV95GRuvdSvA7w4VMwfCjUiPwDi0ZO6Nfe9A==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [linux]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==}
engines: {node: '>=12'}
cpu: [arm]
os: [linux]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-RkT/YXYBTSULo3+af8Ib0ykH8u2MBh57o7q/DAs3lTJlyVQkgQvlrPTnjIzzRPQyavxtPtfg0EopvDyIt0j1rA==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [linux]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==}
engines: {node: '>=12'}
cpu: [ia32]
os: [linux]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-GA48aKNkyQDbd3KtkplYWT102C5sn/EZTY4XROkxONgruHPU72l+gW+FfF8tf2cFjeHaRbWpOYa/uRBz/Xq1Pg==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [linux]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==}
engines: {node: '>=12'}
cpu: [loong64]
os: [linux]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-a4POruNM2oWsD4WKvBSEKGIiWQF8fZOAsycHOt6JBpZ+JN2n2JH9WAv56SOyu9X5IqAjqSIPTaJkqN8F7XOQ5Q==}
+ engines: {node: '>=18'}
+ cpu: [loong64]
+ os: [linux]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==}
engines: {node: '>=12'}
cpu: [mips64el]
os: [linux]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-KabT5I6StirGfIz0FMgl1I+R1H73Gp0ofL9A3nG3i/cYFJzKHhouBV5VWK1CSgKvVaG4q1RNpCTR2LuTVB3fIw==}
+ engines: {node: '>=18'}
+ cpu: [mips64el]
+ os: [linux]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==}
engines: {node: '>=12'}
cpu: [ppc64]
os: [linux]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-gRsL4x6wsGHGRqhtI+ifpN/vpOFTQtnbsupUF5R5YTAg+y/lKelYR1hXbnBdzDjGbMYjVJLJTd2OFmMewAgwlQ==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [linux]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==}
engines: {node: '>=12'}
cpu: [riscv64]
os: [linux]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-hL25LbxO1QOngGzu2U5xeXtxXcW+/GvMN3ejANqXkxZ/opySAZMrc+9LY/WyjAan41unrR3YrmtTsUpwT66InQ==}
+ engines: {node: '>=18'}
+ cpu: [riscv64]
+ os: [linux]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==}
engines: {node: '>=12'}
cpu: [s390x]
os: [linux]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-2k8go8Ycu1Kb46vEelhu1vqEP+UeRVj2zY1pSuPdgvbd5ykAw82Lrro28vXUrRmzEsUV0NzCf54yARIK8r0fdw==}
+ engines: {node: '>=18'}
+ cpu: [s390x]
+ os: [linux]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==}
engines: {node: '>=12'}
cpu: [x64]
os: [linux]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-hzznmADPt+OmsYzw1EE33ccA+HPdIqiCRq7cQeL1Jlq2gb1+OyWBkMCrYGBJ+sxVzve2ZJEVeePbLM2iEIZSxA==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [linux]
+
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-b6pqtrQdigZBwZxAn1UpazEisvwaIDvdbMbmrly7cDTMFnw/+3lVxxCTGOrkPVnsYIosJJXAsILG9XcQS+Yu6w==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [netbsd]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==}
engines: {node: '>=12'}
cpu: [x64]
os: [netbsd]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-OfatkLojr6U+WN5EDYuoQhtM+1xco+/6FSzJJnuWiUw5eVcicbyK3dq5EeV/QHT1uy6GoDhGbFpprUiHUYggrw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [netbsd]
+
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-AFuojMQTxAz75Fo8idVcqoQWEHIXFRbOc1TrVcFSgCZtQfSdc1RXgB3tjOn/krRHENUB4j00bfGjyl2mJrU37A==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openbsd]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==}
engines: {node: '>=12'}
cpu: [x64]
os: [openbsd]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-+A1NJmfM8WNDv5CLVQYJ5PshuRm/4cI6WMZRg1by1GwPIQPCTs1GLEUHwiiQGT5zDdyLiRM/l1G0Pv54gvtKIg==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [openbsd]
+
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-+KrvYb/C8zA9CU/g0sR6w2RBw7IGc5J2BPnc3dYc5VJxHCSF1yNMxTV5LQ7GuKteQXZtspjFbiuW5/dOj7H4Yw==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openharmony]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==}
engines: {node: '>=12'}
cpu: [x64]
os: [sunos]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-ikktIhFBzQNt/QDyOL580ti9+5mL/YZeUPKU2ivGtGjdTYoqz6jObj6nOMfhASpS4GU4Q/Clh1QtxWAvcYKamA==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [sunos]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==}
engines: {node: '>=12'}
cpu: [arm64]
os: [win32]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-7yRhbHvPqSpRUV7Q20VuDwbjW5kIMwTHpptuUzV+AA46kiPze5Z7qgt6CLCK3pWFrHeNfDd1VKgyP4O+ng17CA==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [win32]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==}
engines: {node: '>=12'}
cpu: [ia32]
os: [win32]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-SmwKXe6VHIyZYbBLJrhOoCJRB/Z1tckzmgTLfFYOfpMAx63BJEaL9ExI8x7v0oAO3Zh6D/Oi1gVxEYr5oUCFhw==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [win32]
+
'@esbuild/[email protected]':
resolution: {integrity: sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==}
engines: {node: '>=12'}
cpu: [x64]
os: [win32]
+ '@esbuild/[email protected]':
+ resolution: {integrity: sha512-56hiAJPhwQ1R4i+21FVF7V8kSD5zZTdHcVuRFMW0hn753vVfQN8xlx4uOPT4xoGH0Z/oVATuR82AiqSTDIpaHg==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [win32]
+
+ '@fontsource/[email protected]':
+ resolution: {integrity: sha512-P6r5WnJoKiNVV+zvW2xM13gNdFhAEpQ9dQJHt3naLvfg+LkF2ldgSLiF4T41lf1SQCM9QmkqPTn4TH568IRagg==}
+
+ '@fontsource/[email protected]':
+ resolution: {integrity: sha512-6w8/SG4kqvIMu7xd7wt6x3idn1Qux3p9N62s6G3rfldOUYHpWcc2FKrqf+Vo44jRvqWj2oAtTHrZXEP23oSKwQ==}
+
+ resolution: {integrity: sha512-GwtvgtXxnWsucXvbQXkRgqksiH2Qed37H9xHZocE5sA3N8O8O8/8FA3uclQXxXVzc9XBZuEOMK7+r02FmSpHtw==}
+ engines: {node: '>=18.14.1'}
+ peerDependencies:
+ hono: ^4
+
'@isaacs/[email protected]':
resolution: {integrity: sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==}
engines: {node: '>=12'}
@@ -283,6 +532,25 @@ packages:
'@jridgewell/[email protected]':
resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}
+ '@modelcontextprotocol/[email protected]':
+ resolution: {integrity: sha512-zo37mZA9hJWpULgkRpowewez1y6ML5GsXJPY8FI0tBBCd77HEvza4jDqRKOXgHNn867PVGCyTdzqpz0izu5ZjQ==}
+ engines: {node: '>=18'}
+ peerDependencies:
+ '@cfworker/json-schema': ^4.1.1
+ zod: ^3.25 || ^4.0
+ peerDependenciesMeta:
+ '@cfworker/json-schema':
+ optional: true
+
+ '@napi-rs/[email protected]':
+ resolution: {integrity: sha512-AWPoBRJ9tsnVhor4sjO7rkni+7p+2IAEFj6cx06UgP10jkQHqay/36uRV/bFkgrh18D9vb4cr8Q0Pthskgzy+Q==}
+ peerDependencies:
+ '@emnapi/core': ^1.7.1
+ '@emnapi/runtime': ^1.7.1
+
+ '@oxc-project/[email protected]':
+ resolution: {integrity: sha512-KzkdCd6Uxqnf6l3HOw1xfatAlUURA0g14cvBYFyJ5SaNOQbOUvBr9PKArcPcrNIeRsBdgcUzOGrhKveVpvOIGA==}
+
resolution: {integrity: sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==}
engines: {node: '>=14'}
@@ -290,6 +558,104 @@ packages:
resolution: {integrity: sha512-wwQAWhWSuHaag8c4q/KN/vCoeOJYshAIvMQwD4GpSb3OiZklFfvAgmj0VCBBImRpuF/aFgIRzllXlVX93Jevww==}
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-454rs7jHngixp/NMxd5srYD57OnzSlZ/eFTETjORQHLwJG1lRtmNOJcBerZlfu4GjKqeq8aCCIQrMdHyhI51Hw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [android]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-PcAhP+ynjURNyy8SKGl5DQP94aGuB/7JrXJb/t7P+hanXvQVMWzUvRRhBAcg/lNRadBhoUPqSoP4xw5tR/KBEA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-9YpfeUvSE2RS7wysJ81uOZkXJz7f7Q55H2Gvp3VEw/EsahqDtrphrZ0EwDLK5vvKOzaCrBsjF8JmnMLcUt78Gg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [darwin]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-yB1IlAsSNHncV6SCTL27/MVGR5htvQsoGxIv5KMGXALp+Ll1wYsn+x98M9MW7qa+NdSbvrrY7ANI4wLJ0n1e6g==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-Yi30IVAAfLUCy2MseFjbB1jAMDl1VMCAas5StnYp8da9+CKvMd2H2cbEjWcw5NPaPqzvYkVIaF1nNUG+b7u/sw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-jsO7R8To+AdlYgUmN5sHSCZbfhtMBkO0WUx8iORQnPcMMdgr7qM2DQmMwgabs3GhNztdmoKkMKQFHD6DTMCIQw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-VWkUHwWriDciit80wleYwKILoR/KMvxh/IdwS/paX+ZgpuRpCrKLUdadJbc0NpBEiyhpYawsJ73j9aCvOH+f7Q==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-5f1laC0SlIR0yDbFCd8acUhvJIag6N3zC5P7oUPN6wX0aOma+uKJ0wBDH5aq7I1PVI2ttTlhJwzwRIBnLiSGEg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-Iq4ko0r4XsgbrF/LunNgHtAGLRRVE2kXonAXQ/MV0mC6jQpMOhW1SvtZja2EhC/kd05++bP78dsqBeIQyYJ6Yg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [s390x]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-B8m6tD5+/N5FeNQFbKlLA/2yVq9ycQP1SeedyEYYKWBNR3ZQbkvIUcNnDNM03lO1l5F2roiiFJGgvoLLyZXtSg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-pSdpdUJHkuCxun9LE7jvgUB9qsRgaiyNNCX7m/AvHTcq67AiT/Yhoxvw5zPfhrM8k/BfP8ce/hMOpthKDpEUow==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-OXXS3RKJgX2uLwM+gYyuH5omcH8fL1LJs96pZGgtetVCahON57+d4SJHzTgZiOjxgGkSnpXpOsWuPDGAKAigEg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-JTtb8BWFynicNSoPrehsCzBtOKjZ6jhMiPFEmOiuXg1Fl8dn2KHQob+GuPSGR0dryQa1PQJbzjF3dqO/whhjLg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [wasm32]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-gEdFFEN70A/jxb2svrWsN3aDL7OUtmvlOy+6fa2jxG8K0wQ1ZbdeLGnidov6Yu5/733dI5ySfzFlQ/cb0bSz1g==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [win32]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-eXB7CHuaQdqmJcc3koCNtNPmT/bj2gc999kUFgBxG8Ac0NdgXc4rkCHhqrgrhN3zddvvvrgzj1e90SuSfmyIXA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [win32]
+
+ '@rolldown/[email protected]':
+ resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==}
+
'@rollup/[email protected]':
resolution: {integrity: sha512-XHeJC5Bgvs8LfukDwWZp7yeqin6ns8RTl2B9avbejt6tZqsqvVoWI7ZTQrcNsfKEDWBTnTxM8nMDkO2IFFbd0A==}
engines: {node: '>=14.0.0'}
@@ -355,66 +721,79 @@ packages:
resolution: {integrity: sha512-F8sWbhZ7tyuEfsmOxwc2giKDQzN3+kuBLPwwZGyVkLlKGdV1nvnNwYD0fKQ8+XS6hp9nY7B+ZeK01EBUE7aHaw==}
cpu: [arm]
os: [linux]
+ libc: [glibc]
'@rollup/[email protected]':
resolution: {integrity: sha512-rGfNUfn0GIeXtBP1wL5MnzSj98+PZe/AXaGBCRmT0ts80lU5CATYGxXukeTX39XBKsxzFpEeK+Mrp9faXOlmrw==}
cpu: [arm]
os: [linux]
+ libc: [musl]
'@rollup/[email protected]':
resolution: {integrity: sha512-MMtej3YHWeg/0klK2Qodf3yrNzz6CGjo2UntLvk2RSPlhzgLvYEB3frRvbEF2wRKh1Z2fDIg9KRPe1fawv7C+g==}
cpu: [arm64]
os: [linux]
+ libc: [glibc]
'@rollup/[email protected]':
resolution: {integrity: sha512-1a/qhaaOXhqXGpMFMET9VqwZakkljWHLmZOX48R0I/YLbhdxr1m4gtG1Hq7++VhVUmf+L3sTAf9op4JlhQ5u1Q==}
cpu: [arm64]
os: [linux]
+ libc: [musl]
'@rollup/[email protected]':
resolution: {integrity: sha512-QWO6RQTZ/cqYtJMtxhkRkidoNGXc7ERPbZN7dVW5SdURuLeVU7lwKMpo18XdcmpWYd0qsP1bwKPf7DNSUinhvA==}
cpu: [loong64]
os: [linux]
+ libc: [glibc]
'@rollup/[email protected]':
resolution: {integrity: sha512-xpObYIf+8gprgWaPP32xiN5RVTi/s5FCR+XMXSKmhfoJjrpRAjCuuqQXyxUa/eJTdAE6eJ+KDKaoEqjZQxh3Gw==}
cpu: [loong64]
os: [linux]
+ libc: [musl]
'@rollup/[email protected]':
resolution: {integrity: sha512-4BrCgrpZo4hvzMDKRqEaW1zeecScDCR+2nZ86ATLhAoJ5FQ+lbHVD3ttKe74/c7tNT9c6F2viwB3ufwp01Oh2w==}
cpu: [ppc64]
os: [linux]
+ libc: [glibc]
'@rollup/[email protected]':
resolution: {integrity: sha512-NOlUuzesGauESAyEYFSe3QTUguL+lvrN1HtwEEsU2rOwdUDeTMJdO5dUYl/2hKf9jWydJrO9OL/XSSf65R5+Xw==}
cpu: [ppc64]
os: [linux]
+ libc: [musl]
'@rollup/[email protected]':
resolution: {integrity: sha512-ptA88htVp0AwUUqhVghwDIKlvJMD/fmL/wrQj99PRHFRAG6Z5nbWoWG4o81Nt9FT+IuqUQi+L31ZKAFeJ5Is+A==}
cpu: [riscv64]
os: [linux]
+ libc: [glibc]
'@rollup/[email protected]':
resolution: {integrity: sha512-S51t7aMMTNdmAMPpBg7OOsTdn4tySRQvklmL3RpDRyknk87+Sp3xaumlatU+ppQ+5raY7sSTcC2beGgvhENfuw==}
cpu: [riscv64]
os: [linux]
+ libc: [musl]
'@rollup/[email protected]':
resolution: {integrity: sha512-Bl00OFnVFkL82FHbEqy3k5CUCKH6OEJL54KCyx2oqsmZnFTR8IoNqBF+mjQVcRCT5sB6yOvK8A37LNm/kPJiZg==}
cpu: [s390x]
os: [linux]
+ libc: [glibc]
'@rollup/[email protected]':
resolution: {integrity: sha512-ABca4ceT4N+Tv/GtotnWAeXZUZuM/9AQyCyKYyKnpk4yoA7QIAuBt6Hkgpw8kActYlew2mvckXkvx0FfoInnLg==}
cpu: [x64]
os: [linux]
+ libc: [glibc]
'@rollup/[email protected]':
resolution: {integrity: sha512-HFps0JeGtuOR2convgRRkHCekD7j+gdAuXM+/i6kGzQtFhlCtQkpwtNzkNj6QhCDp7DRJ7+qC/1Vg2jt5iSOFw==}
cpu: [x64]
os: [linux]
+ libc: [musl]
'@rollup/[email protected]':
resolution: {integrity: sha512-H+hXEv9gdVQuDTgnqD+SQffoWoc0Of59AStSzTEj/feWTBAnSfSD3+Dql1ZruJQxmykT/JVY0dE8Ka7z0DH1hw==}
@@ -446,11 +825,38 @@ packages:
cpu: [x64]
os: [win32]
+ '@tybys/[email protected]':
+ resolution: {integrity: sha512-RoBvJ2X0wuKlWFIjrwffGw1IqZHKQqzIchKaadZZfnNpsAYp2mM0h36JtPCjNDAHGgYez/15uMBpfGwchhiMgg==}
+
resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}
- '@types/[email protected]':
- resolution: {integrity: sha512-m0jEgYlYz+mDJZ2+F4v8D1AyQb+QzsNqRuI7xg1VQX/KlKS0qT9r1Mo16yo5F/MtifXFgaofIFsdFMox2SxIbQ==}
+ '@types/[email protected]':
+ resolution: {integrity: sha512-fRa09kZTgu8o71KFcDjUFuc7F+dEbZYZmkI0mg5YBTRs0yMKjYHsq/c0urDKeDb+D5qVgXOdFcuu+DZPKOITwA==}
+
+ '@types/[email protected]':
+ resolution: {integrity: sha512-603BddQMv3pUcr4U2dhujk83N2tTDVr/34wII2B6bJy6g+8WD6yUb11jszNs0gdi4PesVWl7ABt8nYMVpnLUcg==}
+
+ '@types/[email protected]':
+ resolution: {integrity: sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ==}
+ peerDependencies:
+ '@types/react': ^19.2.0
+
+ '@types/[email protected]':
+ resolution: {integrity: sha512-MXfmqaVPEVgkBT/aY0aGCkRWWtByiYQXo3xdQ8r5RzuFrPiRn8Gar2tQdXSUQ2GKV3bkXckek89V8wQBY2Q/Aw==}
+
+ '@vitejs/[email protected]':
+ resolution: {integrity: sha512-DlSMqo4WhThw4vB8Mpn0Woe9J+Jfq1geJ61AKW0QEgLzGMNwtIMdxbDUzLxcun8W7NbJO0e2Jg/Nxm3cCSVzzg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ peerDependencies:
+ '@rolldown/plugin-babel': ^0.1.7 || ^0.2.0
+ babel-plugin-react-compiler: ^1.0.0
+ vite: ^8.0.0
+ peerDependenciesMeta:
+ '@rolldown/plugin-babel':
+ optional: true
+ babel-plugin-react-compiler:
+ optional: true
'@vitest/[email protected]':
resolution: {integrity: sha512-Z2cOr0ksM00MpEfyVE8KXIYPEcBFxdbLSs56L8PO0QQMxt/6bDj45uQfxoc96v05KW3clk7vvgP0qfDit9DmfQ==}
@@ -495,15 +901,35 @@ packages:
'@vitest/[email protected]':
resolution: {integrity: sha512-v0psaMSkNJ3A2NMrUEHFRzJtDPFn+/VWZ5WxImB21T9fjucJRmS7xCS3ppEnARb9y11OAzaD+P2Ps+b+BGX5iQ==}
+ resolution: {integrity: sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==}
+ engines: {node: '>= 0.6'}
+
resolution: {integrity: sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==}
engines: {node: '>=0.4.0'}
hasBin: true
+ resolution: {integrity: sha512-xRQbDb9BnwDafYNn6Vwl839DYVjqXYb1XVGtWAZ1kcDc6iwAL4hg3B1dZlRiuENFeO2H53gFG3in621AdERVAg==}
+ engines: {node: '>=0.4.0'}
+ hasBin: true
+
resolution: {integrity: sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==}
engines: {node: '>= 14'}
+ resolution: {integrity: sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==}
+ peerDependencies:
+ ajv: ^8.0.0
+ peerDependenciesMeta:
+ ajv:
+ optional: true
+
+ resolution: {integrity: sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==}
+
resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==}
engines: {node: '>=8'}
@@ -542,6 +968,10 @@ packages:
resolution: {integrity: sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==}
engines: {node: '>=8'}
+ resolution: {integrity: sha512-2cGmJupaNgg+QUwVLAucDuWuoMZ6EX9iHDRswZ5lsNYEmwPaRknMPCLZz07yTzVq/83p4o/wzbDZbBrTvGGTIw==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==}
@@ -556,6 +986,10 @@ packages:
resolution: {integrity: sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==}
+ resolution: {integrity: sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==}
+ engines: {node: '>= 0.8'}
+
resolution: {integrity: sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==}
engines: {node: '>=8'}
@@ -564,6 +998,10 @@ packages:
resolution: {integrity: sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==}
engines: {node: '>= 0.4'}
+ resolution: {integrity: sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==}
+ engines: {node: '>= 0.4'}
+
resolution: {integrity: sha512-4zNhdJD/iOjSH0A05ea+Ke6MU5mmpQcbQsSOkgdaUMJ9zTlDTD/GYlwohmIE2u0gaxHYiVHEn1Fw9mZ/ktJWgw==}
engines: {node: '>=18'}
@@ -606,6 +1044,36 @@ packages:
resolution: {integrity: sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==}
+ resolution: {integrity: sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==}
+
+ resolution: {integrity: sha512-ysOGlgTFbN2/Y6Cg3Iye8YKulHw+R2fNXHrgSmXISQdMnomY6eNDprVdW9R5xBguEqI954+S6709UyiO7B+6OQ==}
+
+ resolution: {integrity: sha512-5jRCH9Z/+DRP7rkvY83B+yGIGX96OYdJmzngqnw2SBSxqCFPd0w2km3s5iawpGX8krnwSGmF0FW5Nhr0Hfai3g==}
+ engines: {node: '>=18'}
+
+ resolution: {integrity: sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==}
+ engines: {node: '>= 0.6'}
+
+ resolution: {integrity: sha512-j/O/d7GcZCyNl7/hwZAb606rzqkyvaDctLmckbxLzHvFBzTJHuGEdodATcP3yIRoDrLHkIATJuvzbFlp/ki2cQ==}
+ engines: {node: '>=18'}
+
+ resolution: {integrity: sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==}
+ engines: {node: '>=6.6.0'}
+
+ resolution: {integrity: sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==}
+ engines: {node: '>= 0.6'}
+
+ resolution: {integrity: sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==}
+ engines: {node: '>= 0.10'}
+
resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==}
engines: {node: '>= 8'}
@@ -614,6 +1082,9 @@ packages:
resolution: {integrity: sha512-2z+rWdzbbSZv6/rhtvzvqeZQHrBaqgogqt85sqFNbabZOuFbCVFb8kPeEtZjiKkbrm395irpNKiYeFeLiQnFPg==}
engines: {node: '>=18'}
+ resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}
+
resolution: {integrity: sha512-ZYP5VBHshaDAiVZxjbRVcFJpc+4xGgT0bK3vzy1HLN8jTO975HEbuYzZJcHoQEY5K1a0z8YayJkyVETa08eNTg==}
engines: {node: '>=18'}
@@ -638,6 +1109,22 @@ packages:
resolution: {integrity: sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==}
engines: {node: '>=0.4.0'}
+ resolution: {integrity: sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==}
+ engines: {node: '>= 0.8'}
+
+ resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}
+ engines: {node: '>=8'}
+
+ resolution: {integrity: sha512-WuNoO2wl3rGI8MaTuvmfgViek4WafHLD9Kf//Hw69g8TgAHSpAWr6RW15kU6U9vwtQxIi/YBxQNcIA5RzQ46Fw==}
+
+ resolution: {integrity: sha512-vBnxWVk0f665z1Zyx598l/BMUjHD3SK5V4XorxpYGjaSREM8lLc8O6ylgKTtw+ZnCOMYOhcwov9x0ubfFazvMw==}
+ peerDependencies:
+ react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
+
resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==}
engines: {node: '>= 0.4'}
@@ -645,6 +1132,14 @@ packages:
resolution: {integrity: sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==}
+ resolution: {integrity: sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==}
+
+ resolution: {integrity: sha512-8CYHJP5O4wFO+ycoJR98yy907MmPeo+vWXrzjxmGGgRNKqv8pOjjm+wphO0CCgQJnBU7+QUPSJS4QXhbKrO50w==}
+ engines: {node: '>= 22.12.0'}
+ hasBin: true
+
resolution: {integrity: sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==}
@@ -654,6 +1149,10 @@ packages:
resolution: {integrity: sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==}
+ resolution: {integrity: sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==}
+ engines: {node: '>= 0.8'}
+
resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==}
engines: {node: '>=0.12'}
@@ -662,6 +1161,10 @@ packages:
resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==}
engines: {node: '>=0.12'}
+ resolution: {integrity: sha512-dtJUTepzMW3Lm/NPxRf3wP4642UWhjL2sQxc+ym2YMj1m/H2zDNQOlezafzkHwn6sMstjHTwG6iQQsctDW/b1A==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
resolution: {integrity: sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==}
engines: {node: '>= 0.4'}
@@ -686,16 +1189,55 @@ packages:
engines: {node: '>=12'}
hasBin: true
+ resolution: {integrity: sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ resolution: {integrity: sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==}
+
resolution: {integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==}
resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==}
+ resolution: {integrity: sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==}
+ engines: {node: '>= 0.6'}
+
+ resolution: {integrity: sha512-kJezFj9YFAMLeORyi7aCLxLbD5/qWMQnoMVlVPyHIll7lgRJCc3JVln9Vgl9nwQi0YkMnhdGTMNn7CkRRAptMg==}
+ engines: {node: '>=18.0.0'}
+
+ resolution: {integrity: sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA==}
+ engines: {node: '>=18.0.0'}
+
resolution: {integrity: sha512-knvyeauYhqjOYvQ66MznSMs83wmHrCycNEN6Ao+2AeYEfxUIkuiVxdEa1qlGEPK+We3n0THiDciYSsCcgW/DoA==}
engines: {node: '>=12.0.0'}
+ resolution: {integrity: sha512-5Kb34ipNX694DH48vN9irak1Qx30nb0PLYHXfJgw4YEjiC3ZEmZJhwOp+VfiCYwFzvFTdB9QkArYS5kXa2cx2A==}
+ engines: {node: '>= 16'}
+ peerDependencies:
+ express: '>= 4.11'
+
+ resolution: {integrity: sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==}
+ engines: {node: '>= 18'}
+
+ resolution: {integrity: sha512-LmDxfWXwcTArk8fUEnOfSZpHOJ6zOMUJKOtFLFqJLoKJetuQG874Uc7/Kki7zFLzYybmZhp1M7+98pfMqeX8yA==}
+
+ resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==}
+
+ resolution: {integrity: sha512-rVjf7ArG3LTk+FS6Yw81V1DLuZl1bRbNrev6Tmd/9RaroeeRRJhAt7jg/6YFxbvAQXUCavSoZhPPj6oOx+5KjQ==}
+
resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}
engines: {node: '>=12.0.0'}
@@ -712,6 +1254,10 @@ packages:
resolution: {integrity: sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==}
engines: {node: '>=8'}
+ resolution: {integrity: sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==}
+ engines: {node: '>= 18.0.0'}
+
resolution: {integrity: sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==}
@@ -723,6 +1269,14 @@ packages:
resolution: {integrity: sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==}
engines: {node: '>= 6'}
+ resolution: {integrity: sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==}
+ engines: {node: '>= 0.6'}
+
+ resolution: {integrity: sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==}
+ engines: {node: '>= 0.8'}
+
resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
@@ -756,6 +1310,9 @@ packages:
resolution: {integrity: sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==}
engines: {node: '>= 0.4'}
+ resolution: {integrity: sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==}
+
resolution: {integrity: sha512-KyrFvnl+J9US63TEzwoiJOQzZBJY7KgBushJA8X61DMbNsH+2ONkDuLDnCnwUiPTF42tLoEmrPyoqbenVA5zrg==}
engines: {node: '>=18.0.0'}
@@ -776,6 +1333,10 @@ packages:
resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==}
engines: {node: '>= 0.4'}
+ resolution: {integrity: sha512-uyZtpnYxM9CmQ7QsQknM4zN8EftNqhON1qYeIKM0Se67CCEe2c44xyGURwB0axX2fBDu1dqHrHAc1hmNT8ITkw==}
+ engines: {node: '>=16.9.0'}
+
resolution: {integrity: sha512-Y22oTqIU4uuPgEemfz7NDJz6OeKf12Lsu+QC+s3BVpda64lTiMYCyGwg5ki4vFxkMwQdeZDl2adZoqUgdFuTgQ==}
engines: {node: '>=18'}
@@ -783,6 +1344,10 @@ packages:
resolution: {integrity: sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==}
+ resolution: {integrity: sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==}
+ engines: {node: '>= 0.8'}
+
resolution: {integrity: sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==}
engines: {node: '>= 14'}
@@ -795,6 +1360,21 @@ packages:
resolution: {integrity: sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==}
engines: {node: '>=0.10.0'}
+ resolution: {integrity: sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw==}
+ engines: {node: '>=0.10.0'}
+
+ resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==}
+
+ resolution: {integrity: sha512-/+S6j4E9AHvW9SWMSEY9Xfy66O5PWvVEJ08O0y5JGyEKQpojb0K0GKpz/v5HJ/G0vi3D2sjGK78119oXZeE0qA==}
+ engines: {node: '>= 12'}
+
+ resolution: {integrity: sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==}
+ engines: {node: '>= 0.10'}
+
resolution: {integrity: sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==}
engines: {node: '>=8'}
@@ -826,6 +1406,9 @@ packages:
resolution: {integrity: sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==}
+ resolution: {integrity: sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==}
+
resolution: {integrity: sha512-43r2mRvz+8JRIKnWJ+3j8JtjRKZ6GmjzfaE/qiBJnikNnYv/6bagRJ1kUhNk8R5EX/GkobD+r+sfxCPJsiKBLQ==}
engines: {node: '>=12'}
@@ -856,6 +1439,9 @@ packages:
resolution: {integrity: sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==}
+ resolution: {integrity: sha512-YYVDInQKFJfR/xa3ojUTl8c2KoTwiL1R5Wg9YCydwH0x0B9grbzlg5HC7mMjCtUJjbQ/YnGEZIhI5tCgfTb4Hw==}
+
resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==}
@@ -868,6 +1454,90 @@ packages:
canvas:
optional: true
+ resolution: {integrity: sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==}
+
+ resolution: {integrity: sha512-fQhoXdcvc3V28x7C7BMs4P5+kNlgUURe2jmUT1T//oBRMDrqy1QPelJimwZGo7Hg9VPV3EQV5Bnq4hbFy2vetA==}
+
+ resolution: {integrity: sha512-YK7/ClTt4kAK0vo6w3X+Pnm0D2cf2vPHbhOXdoNti1Ga0al1P4TBZhwjATvjNwLEBCnKvjJc2jQgHXH0NEwlAg==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm64]
+ os: [android]
+
+ resolution: {integrity: sha512-RzeG9Ju5bag2Bv1/lwlVJvBE3q6TtXskdZLLCyfg5pt+HLz9BqlICO7LZM7VHNTTn/5PRhHFBSjk5lc4cmscPQ==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm64]
+ os: [darwin]
+
+ resolution: {integrity: sha512-U+QsBp2m/s2wqpUYT/6wnlagdZbtZdndSmut/NJqlCcMLTWp5muCrID+K5UJ6jqD2BFshejCYXniPDbNh73V8w==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [x64]
+ os: [darwin]
+
+ resolution: {integrity: sha512-JCTigedEksZk3tHTTthnMdVfGf61Fky8Ji2E4YjUTEQX14xiy/lTzXnu1vwiZe3bYe0q+SpsSH/CTeDXK6WHig==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [x64]
+ os: [freebsd]
+
+ resolution: {integrity: sha512-x6rnnpRa2GL0zQOkt6rts3YDPzduLpWvwAF6EMhXFVZXD4tPrBkEFqzGowzCsIWsPjqSK+tyNEODUBXeeVHSkw==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm]
+ os: [linux]
+
+ resolution: {integrity: sha512-0nnMyoyOLRJXfbMOilaSRcLH3Jw5z9HDNGfT/gwCPgaDjnx0i8w7vBzFLFR1f6CMLKF8gVbebmkUN3fa/kQJpQ==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ resolution: {integrity: sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ resolution: {integrity: sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ resolution: {integrity: sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ resolution: {integrity: sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm64]
+ os: [win32]
+
+ resolution: {integrity: sha512-Amq9B/SoZYdDi1kFrojnoqPLxYhQ4Wo5XiL8EVJrVsB8ARoC1PWW6VGtT0WKCemjy8aC+louJnjS7U18x3b06Q==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [x64]
+ os: [win32]
+
+ resolution: {integrity: sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ==}
+ engines: {node: '>= 12.0.0'}
+
+ resolution: {integrity: sha512-++gUqRDEvcnN6Zhqrr+y/CkVEHhlrR96vZn3nZZPYzMcBUyBtTKzB9NadClFIsIVSsu+3i9tfk/erqy9kAmt7Q==}
+ engines: {node: '>=14'}
+
resolution: {integrity: sha512-i24m8rpwhmPIS4zscNzK6MSEhk0DUWa/8iYQWxhffV8jkI4Phvs3F+quL5xvS0gdQR0FyTCMMH33Y78dDTzzIw==}
engines: {node: '>=18'}
@@ -878,6 +1548,11 @@ packages:
resolution: {integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==}
+ resolution: {integrity: sha512-reEZMXq8Qdd5jg5XYkQ5TR1fB/GiQ7ih4vcrthYDtgjSDwh0i6/YLiGjsWsIwgN49gpAnd4J2elSNzncMEEUUQ==}
+ peerDependencies:
+ react: ^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0
+
resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
@@ -892,14 +1567,30 @@ packages:
resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==}
engines: {node: '>= 0.4'}
+ resolution: {integrity: sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==}
+ engines: {node: '>= 0.8'}
+
+ resolution: {integrity: sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==}
engines: {node: '>= 0.6'}
+ resolution: {integrity: sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==}
+ engines: {node: '>= 0.6'}
+
resolution: {integrity: sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==}
engines: {node: '>= 0.6'}
+ resolution: {integrity: sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==}
engines: {node: '>=18'}
@@ -919,6 +1610,9 @@ packages:
resolution: {integrity: sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==}
engines: {node: '>=16 || 14 >=14.17'}
+ resolution: {integrity: sha512-d+ObxMQFmbt10sretNDytwt85VrbkhhUA/JBGm1MPaWJ65Cl4wOgLaB1NYvJSZ0Ef03MMEU/0xpPMXUIQ29UfA==}
+
resolution: {integrity: sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==}
engines: {node: '>=10'}
@@ -931,6 +1625,15 @@ packages:
engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
hasBin: true
+ resolution: {integrity: sha512-sPdqC6ByMVVGvF1ynvvMo0/o+oD1VX7DaHhijt1bFgjvBkHBib4t49GoNDhf2NDta4oeUNlaGbSt5K7qjZ955Q==}
+ engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
+ hasBin: true
+
+ resolution: {integrity: sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==}
+ engines: {node: '>= 0.6'}
+
resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==}
engines: {node: '>=0.10.0'}
@@ -938,6 +1641,21 @@ packages:
resolution: {integrity: sha512-7wfH4sLbt4M0gCDzGE6vzQBo0bfTKjU7Sfpqy/7gs1qBfYz2vEJH6vXcBKpO3+6Yu1telwd0t9HpyOoLEQQbIQ==}
+ resolution: {integrity: sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==}
+ engines: {node: '>=0.10.0'}
+
+ resolution: {integrity: sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==}
+ engines: {node: '>= 0.4'}
+
+ resolution: {integrity: sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==}
+ engines: {node: '>= 0.8'}
+
+ resolution: {integrity: sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==}
+
resolution: {integrity: sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==}
engines: {node: '>=18'}
@@ -952,6 +1670,10 @@ packages:
resolution: {integrity: sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==}
+ resolution: {integrity: sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==}
+ engines: {node: '>= 0.8'}
+
resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==}
engines: {node: '>=8'}
@@ -963,9 +1685,15 @@ packages:
resolution: {integrity: sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==}
engines: {node: '>=16 || 14 >=14.18'}
+ resolution: {integrity: sha512-qRcuIdP69NPm4qbACK+aDogI5CBDMi1jKe0ry5rSQJz8JVLsC7jV8XpiJjGRLLol3N+R5ihGYcrPLTno6pAdBA==}
+
resolution: {integrity: sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==}
+ resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==}
+
resolution: {integrity: sha512-//nshmD55c46FuFw26xV/xFAaB5HF9Xdap7HJBBnrKdAd6/GxDBaNA1870O79+9ueg61cZLSVc+OaFlfmObYVQ==}
engines: {node: '>= 14.16'}
@@ -981,21 +1709,75 @@ packages:
resolution: {integrity: sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==}
engines: {node: '>=12'}
+ resolution: {integrity: sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==}
+ engines: {node: '>=12'}
+
+ resolution: {integrity: sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ==}
+ engines: {node: '>=16.20.0'}
+
+ resolution: {integrity: sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ==}
+
+ resolution: {integrity: sha512-y+ichcgc2LrADuhLNAx8DFjVfgz91pRxfZdI3UDhxHvcVEZsenLO+7XaU5vOp0u/7V/wZ+plyuQxtrDlZJ+yeg==}
+
+ resolution: {integrity: sha512-FfR8sjd4em2T6fb3I2MwAJU7HWVMr9zba+enmQeeWFfCbm+UOC/0X4DS8XtpUTMwWMGbjKYP7xjfNekzyGmB3A==}
+ engines: {node: ^10 || ^12 || >=14}
+
resolution: {integrity: sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==}
engines: {node: ^10 || ^12 || >=14}
+ resolution: {integrity: sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA==}
+ engines: {node: '>=0.4.0'}
+
+ resolution: {integrity: sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==}
+ engines: {node: '>= 0.10'}
+
resolution: {integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==}
engines: {node: '>=6'}
+ resolution: {integrity: sha512-Rzq0KEyX/w/tEybncDgdkZrJgVUsUMk3xjh3t5bv3S1HTAtg+uOYt72+ZfwiQwKdysThkTBdL/rTi6HDmX9Ddw==}
+ engines: {node: '>=0.6'}
+
+ resolution: {integrity: sha512-AifT7QEbW9Nri4tAwR5M/uzpBuqfZf+zwaEM/QkzEjj7NBuFD2rBuy0K3dE+8wltbezDV7JMA0WfnCPYRSYbXA==}
+
resolution: {integrity: sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==}
+ resolution: {integrity: sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==}
+ engines: {node: '>= 0.6'}
+
+ resolution: {integrity: sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==}
+ engines: {node: '>= 0.10'}
+
+ resolution: {integrity: sha512-t0BRVXvbiE/o20Hfw669rLbMCDWtYZLvmJigy2f0MxsXF+71pxhR3xOkspmsO8h3ZlNzyibAmtCa3l4lYKk6gQ==}
+ peerDependencies:
+ react: ^19.2.7
+
+ resolution: {integrity: sha512-HNe9WslTbXmFK8o8cmwgAeJFSBvt1bPdHCVKtaaV+WlAN36mpT4hcRpwbf3fY56ar2oIXzsBpOAiIRHAdY0OlQ==}
+ engines: {node: '>=0.10.0'}
+
resolution: {integrity: sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==}
engines: {node: '>=8.10.0'}
+ resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==}
+ engines: {node: '>=0.10.0'}
+
resolution: {integrity: sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==}
engines: {node: '>= 0.4'}
@@ -1009,6 +1791,11 @@ packages:
resolution: {integrity: sha512-l0OE8wL34P4nJH/H2ffoaniAokM2qSmrtXHmlpvYr5AVVX8msAyW0l8NVJFDxlSK4u3Uh/f41cQheDVdnYijwQ==}
hasBin: true
+ resolution: {integrity: sha512-i00lAJ2ks1BYr7rjNjKC7BcqAS7nVfiT3QX1SI5aY+AFHblCmaUf9OE9dbdzDvW6dJxbi2ZCZiy9v3CcwOiX3g==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ hasBin: true
+
resolution: {integrity: sha512-d0UrqxYd8KyZ6i3M2Nx7WOMy708qsV/7fTHMHxCMCBOAe3V/U7OMPu5GkX8hC+cmkHhzGnfeYongl1IgiooddA==}
engines: {node: '>=16'}
@@ -1021,6 +1808,10 @@ packages:
engines: {node: '>=18.0.0', npm: '>=8.0.0'}
hasBin: true
+ resolution: {integrity: sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==}
+ engines: {node: '>= 18'}
+
resolution: {integrity: sha512-TrEMa7JGdVm0UThDJSx7ddw5nVm3UJS9o9CCIZ72B1vSyEZoziDqBYP3XIoi/12lKrJR8rE3jeFHMok2F/Mnsg==}
@@ -1037,14 +1828,28 @@ packages:
resolution: {integrity: sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==}
engines: {node: '>=v12.22.7'}
+ resolution: {integrity: sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==}
+
resolution: {integrity: sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==}
engines: {node: '>=10'}
hasBin: true
+ resolution: {integrity: sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==}
+ engines: {node: '>= 18'}
+
resolution: {integrity: sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==}
+ resolution: {integrity: sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==}
+ engines: {node: '>= 18'}
+
+ resolution: {integrity: sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==}
+
resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==}
engines: {node: '>=8'}
@@ -1053,6 +1858,22 @@ packages:
resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==}
engines: {node: '>=8'}
+ resolution: {integrity: sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==}
+ engines: {node: '>= 0.4'}
+
+ resolution: {integrity: sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==}
+ engines: {node: '>= 0.4'}
+
+ resolution: {integrity: sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==}
+ engines: {node: '>= 0.4'}
+
+ resolution: {integrity: sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==}
+ engines: {node: '>= 0.4'}
+
resolution: {integrity: sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==}
@@ -1081,6 +1902,10 @@ packages:
resolution: {integrity: sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==}
+ resolution: {integrity: sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==}
+ engines: {node: '>= 0.8'}
+
resolution: {integrity: sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==}
@@ -1108,6 +1933,10 @@ packages:
resolution: {integrity: sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==}
engines: {node: '>=12'}
+ resolution: {integrity: sha512-MvjXzkz/BOfyVDkG0oFOtBxHX2u3gKbMHIF/dXblZsgD3BWOFLmHovIpZY7BykJdAjcqRCBi1WYBNdEC9yI7vg==}
+ engines: {node: '>= 8.0'}
+
resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
engines: {node: '>=8'}
@@ -1138,6 +1967,10 @@ packages:
resolution: {integrity: sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==}
engines: {node: '>=12.0.0'}
+ resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==}
+ engines: {node: '>=12.0.0'}
+
resolution: {integrity: sha512-Zba82s87IFq9A9XmjiX5uZA/ARWDrB03OHlq+Vw1fSdt0I+4/Kutwy8BP4Y/y/aORMo61FQ0vIb5j44vSo5Pkg==}
engines: {node: ^18.0.0 || >=20.0.0}
@@ -1161,6 +1994,10 @@ packages:
resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==}
engines: {node: '>=8.0'}
+ resolution: {integrity: sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==}
+ engines: {node: '>=0.6'}
+
resolution: {integrity: sha512-sf4i37nQ2LBx4m3wB74y+ubopq6W/dIzXg0FDGjsYnZHVa1Da8FH853wlL2gtUhg+xJXjfk3kUZS3BRoQeoQBQ==}
engines: {node: '>=6'}
@@ -1176,19 +2013,57 @@ packages:
resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
+ resolution: {integrity: sha512-faYHw0anBbc/kWF3zFTEnxSFOAGUX9GFbOBthvDdLsIlEoWOFOtS0zgCiQYwIskL9iGXZL3kAXD8OoZ4GmMATA==}
+ engines: {node: '>= 18'}
+
resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==}
engines: {node: '>=14.17'}
hasBin: true
- resolution: {integrity: sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==}
+ resolution: {integrity: sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==}
+ engines: {node: '>=14.17'}
+ hasBin: true
+
+ resolution: {integrity: sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA==}
+
+ resolution: {integrity: sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==}
+
+ resolution: {integrity: sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==}
+
+ resolution: {integrity: sha512-cRZYrTDwWznlnRiPjggAGxZXanty6M8RV1ff8Wm4LWXBp7/IG8v5DnOm74DtUBp9OONpK75YlPnIjQqX0dBDtA==}
+ engines: {node: '>=20.18.1'}
+
+ resolution: {integrity: sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==}
+ engines: {node: '>= 0.8'}
+
+ resolution: {integrity: sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==}
+ engines: {node: '>= 0.8'}
resolution: {integrity: sha512-AM9aQ/IPrW/6ENLQg3AGY4K1N2TGZdR5e4gu/MmmR2xR3Ll1+dib+nook92g4TV3PXVyeyxdWwtaCAiUL0hMxA==}
engines: {node: ^18.0.0 || >=20.0.0}
hasBin: true
+ resolution: {integrity: sha512-/9CBdUqnCgwWXn61v5PErWnR5q3Bfne2oI52uHzgJnKnlaoNgEKvxOzS0/XssDXWMK3ElStM2+J/Ko4Q63XhMA==}
+
+ resolution: {integrity: sha512-YBpc7l0gQMAhmt/aETr1Xa4IXEmPUFEoY+2FZK05wusfdsqtvAVcSGStfOPc/JpQBdtLPwFNERoxUB/brn8VLw==}
+ peerDependencies:
+ vite-plugin-electron-renderer: '*'
+ peerDependenciesMeta:
+ vite-plugin-electron-renderer:
+ optional: true
+
resolution: {integrity: sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==}
engines: {node: ^18.0.0 || >=20.0.0}
@@ -1220,6 +2095,49 @@ packages:
terser:
optional: true
+ resolution: {integrity: sha512-h9bXPmJichP5fLmVQo3PyaGSDE2n3aPuomeAlVRm0JLmt4rY6zmPKd59HYI4LNW8oTK7tlTsuC7l/m7awx9Jcw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ hasBin: true
+ peerDependencies:
+ '@types/node': ^20.19.0 || >=22.12.0
+ '@vitejs/devtools': ^0.1.18
+ esbuild: ^0.27.0 || ^0.28.0
+ jiti: '>=1.21.0'
+ less: ^4.0.0
+ sass: ^1.70.0
+ sass-embedded: ^1.70.0
+ stylus: '>=0.54.8'
+ sugarss: ^5.0.0
+ terser: ^5.16.0
+ tsx: ^4.8.1
+ yaml: ^2.4.2
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+ '@vitejs/devtools':
+ optional: true
+ esbuild:
+ optional: true
+ jiti:
+ optional: true
+ less:
+ optional: true
+ sass:
+ optional: true
+ sass-embedded:
+ optional: true
+ stylus:
+ optional: true
+ sugarss:
+ optional: true
+ terser:
+ optional: true
+ tsx:
+ optional: true
+ yaml:
+ optional: true
+
resolution: {integrity: sha512-MSmPM9REYqDGBI8439mA4mWhV5sKmDlBKWIYbA3lRb2PTHACE0mgKwA8yQ2xq9vxDTuk4iPrECBAEW2aoFXY0Q==}
engines: {node: ^18.0.0 || >=20.0.0}
@@ -1288,6 +2206,9 @@ packages:
resolution: {integrity: sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==}
engines: {node: '>=12'}
+ resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==}
+
resolution: {integrity: sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg==}
engines: {node: '>=10.0.0'}
@@ -1307,6 +2228,32 @@ packages:
resolution: {integrity: sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==}
+ resolution: {integrity: sha512-O/PgfnpT1xKSDeQYSCfRI5Gy3hPf91mKVDuYLUHZJMiDFptvP41MSnWofm8dnCm0256ZNfZIM7DSzuSMAFnjHA==}
+ peerDependencies:
+ zod: ^3.25.28 || ^4
+
+ resolution: {integrity: sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ==}
+
+ resolution: {integrity: sha512-/8tAspM5LMPr28b3fwLYrtdj77ECpfZviaP75CMTnwO8ISyaE4GDIG/9rDDYq/cH9D2Xw2A2RXglLInmVBQB/g==}
+ engines: {node: '>=12.20.0'}
+ peerDependencies:
+ '@types/react': '>=18.0.0'
+ immer: '>=9.0.6'
+ react: '>=18.0.0'
+ use-sync-external-store: '>=1.2.0'
+ peerDependenciesMeta:
+ '@types/react':
+ optional: true
+ immer:
+ optional: true
+ react:
+ optional: true
+ use-sync-external-store:
+ optional: true
+
snapshots:
'@ampproject/[email protected]':
@@ -1370,75 +2317,192 @@ snapshots:
'@csstools/[email protected]':
optional: true
+ '@electron-internal/[email protected]': {}
+
+ '@electron/[email protected]':
+ dependencies:
+ debug: 4.4.3
+ env-paths: 3.0.0
+ graceful-fs: 4.2.11
+ progress: 2.0.3
+ semver: 7.7.4
+ sumchecker: 3.0.1
+ optionalDependencies:
+ undici: 7.28.0
+ transitivePeerDependencies:
+ - supports-color
+
+ '@emnapi/[email protected]':
+ dependencies:
+ '@emnapi/wasi-threads': 1.2.1
+ tslib: 2.8.1
+ optional: true
+
+ '@emnapi/[email protected]':
+ dependencies:
+ tslib: 2.8.1
+ optional: true
+
+ '@emnapi/[email protected]':
+ dependencies:
+ tslib: 2.8.1
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
'@esbuild/[email protected]':
optional: true
+ '@esbuild/[email protected]':
+ optional: true
+
+ '@fontsource/[email protected]': {}
+
+ '@fontsource/[email protected]': {}
+
+ dependencies:
+ hono: 4.12.26
+
'@isaacs/[email protected]':
dependencies:
string-width: 5.1.2
@@ -1462,17 +2526,99 @@ snapshots:
'@jridgewell/gen-mapping': 0.3.13
'@jridgewell/trace-mapping': 0.3.31
- '@jridgewell/[email protected]': {}
+ '@jridgewell/[email protected]': {}
+
+ '@jridgewell/[email protected]':
+ dependencies:
+ '@jridgewell/resolve-uri': 3.1.2
+ '@jridgewell/sourcemap-codec': 1.5.5
+
+ '@modelcontextprotocol/[email protected]([email protected])':
+ dependencies:
+ '@hono/node-server': 1.19.14([email protected])
+ ajv: 8.20.0
+ ajv-formats: 3.0.1([email protected])
+ content-type: 1.0.5
+ cors: 2.8.6
+ cross-spawn: 7.0.6
+ eventsource: 3.0.7
+ eventsource-parser: 3.1.0
+ express: 5.2.1
+ express-rate-limit: 8.5.2([email protected])
+ hono: 4.12.26
+ jose: 6.2.3
+ json-schema-typed: 8.0.2
+ pkce-challenge: 5.0.1
+ raw-body: 3.0.2
+ zod: 4.4.3
+ zod-to-json-schema: 3.25.2([email protected])
+ transitivePeerDependencies:
+ - supports-color
+
+ dependencies:
+ '@emnapi/core': 1.10.0
+ '@emnapi/runtime': 1.10.0
+ '@tybys/wasm-util': 0.10.2
+ optional: true
+
+ '@oxc-project/[email protected]': {}
+
+ '@pkgjs/[email protected]':
+ optional: true
+
+ '@polka/[email protected]': {}
+
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]':
+ optional: true
- '@jridgewell/[email protected]':
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]':
dependencies:
- '@jridgewell/resolve-uri': 3.1.2
- '@jridgewell/sourcemap-codec': 1.5.5
+ '@emnapi/core': 1.10.0
+ '@emnapi/runtime': 1.10.0
+ '@napi-rs/wasm-runtime': 1.1.5(@emnapi/[email protected])(@emnapi/[email protected])
+ optional: true
- '@pkgjs/[email protected]':
+ '@rolldown/[email protected]':
optional: true
- '@polka/[email protected]': {}
+ '@rolldown/[email protected]':
+ optional: true
+
+ '@rolldown/[email protected]': {}
dependencies:
@@ -1574,12 +2720,33 @@ snapshots:
'@rollup/[email protected]':
optional: true
+ '@tybys/[email protected]':
+ dependencies:
+ tslib: 2.8.1
+ optional: true
+
'@types/[email protected]': {}
- '@types/[email protected]':
+ '@types/[email protected]':
dependencies:
- undici-types: 7.16.0
- optional: true
+ undici-types: 7.18.2
+
+ '@types/[email protected]':
+ dependencies:
+ undici-types: 7.24.6
+
+ dependencies:
+ '@types/react': 19.2.17
+
+ '@types/[email protected]':
+ dependencies:
+ csstype: 3.2.3
+
+ dependencies:
+ '@rolldown/pluginutils': 1.0.1
dependencies:
@@ -1595,7 +2762,7 @@ snapshots:
std-env: 3.10.0
test-exclude: 7.0.2
tinyrainbow: 1.2.0
transitivePeerDependencies:
- supports-color
@@ -1606,13 +2773,13 @@ snapshots:
chai: 5.3.3
tinyrainbow: 1.2.0
dependencies:
'@vitest/spy': 2.1.9
estree-walker: 3.0.3
magic-string: 0.30.21
optionalDependencies:
- vite: 5.4.21(@types/[email protected])([email protected])
'@vitest/[email protected]':
dependencies:
@@ -1642,7 +2809,7 @@ snapshots:
sirv: 3.0.2
tinyglobby: 0.2.15
tinyrainbow: 1.2.0
'@vitest/[email protected]':
dependencies:
@@ -1650,11 +2817,29 @@ snapshots:
loupe: 3.2.1
tinyrainbow: 1.2.0
+ dependencies:
+ mime-types: 3.0.2
+ negotiator: 1.0.0
+
+
optional: true
+ optionalDependencies:
+ ajv: 8.20.0
+
+ dependencies:
+ fast-deep-equal: 3.1.3
+ fast-uri: 3.1.2
+ json-schema-traverse: 1.0.0
+ require-from-string: 2.0.2
+
@@ -1681,6 +2866,20 @@ snapshots:
+ dependencies:
+ bytes: 3.1.2
+ content-type: 2.0.0
+ debug: 4.4.3
+ http-errors: 2.0.1
+ iconv-lite: 0.7.2
+ on-finished: 2.4.1
+ qs: 6.15.2
+ raw-body: 3.0.2
+ type-is: 2.1.0
+ transitivePeerDependencies:
+ - supports-color
+
dependencies:
balanced-match: 1.0.2
@@ -1695,13 +2894,19 @@ snapshots:
+
dependencies:
es-errors: 1.3.0
function-bind: 1.1.2
- optional: true
+
+ dependencies:
+ call-bind-apply-helpers: 1.0.2
+ get-intrinsic: 1.3.0
dependencies:
@@ -1748,6 +2953,25 @@ snapshots:
+
+
+
+
+
+
+
+ dependencies:
+ object-assign: 4.1.1
+ vary: 1.1.2
+
dependencies:
path-key: 3.1.1
@@ -1760,6 +2984,8 @@ snapshots:
rrweb-cssom: 0.8.0
optional: true
+
dependencies:
whatwg-mimetype: 4.0.0
@@ -1778,38 +3004,59 @@ snapshots:
optional: true
+
+
+
+ dependencies:
+ dockview-core: 6.6.1
+ react: 19.2.7
+
dependencies:
call-bind-apply-helpers: 1.0.2
es-errors: 1.3.0
gopd: 1.2.0
- optional: true
+
+ dependencies:
+ '@electron-internal/extract-zip': 1.0.3
+ '@electron/get': 5.0.0
+ '@types/node': 24.13.2
+ transitivePeerDependencies:
+ - supports-color
+
+
optional: true
- optional: true
- optional: true
+
dependencies:
es-errors: 1.3.0
- optional: true
dependencies:
@@ -1845,24 +3092,122 @@ snapshots:
'@esbuild/win32-ia32': 0.21.5
'@esbuild/win32-x64': 0.21.5
+ optionalDependencies:
+ '@esbuild/aix-ppc64': 0.27.7
+ '@esbuild/android-arm': 0.27.7
+ '@esbuild/android-arm64': 0.27.7
+ '@esbuild/android-x64': 0.27.7
+ '@esbuild/darwin-arm64': 0.27.7
+ '@esbuild/darwin-x64': 0.27.7
+ '@esbuild/freebsd-arm64': 0.27.7
+ '@esbuild/freebsd-x64': 0.27.7
+ '@esbuild/linux-arm': 0.27.7
+ '@esbuild/linux-arm64': 0.27.7
+ '@esbuild/linux-ia32': 0.27.7
+ '@esbuild/linux-loong64': 0.27.7
+ '@esbuild/linux-mips64el': 0.27.7
+ '@esbuild/linux-ppc64': 0.27.7
+ '@esbuild/linux-riscv64': 0.27.7
+ '@esbuild/linux-s390x': 0.27.7
+ '@esbuild/linux-x64': 0.27.7
+ '@esbuild/netbsd-arm64': 0.27.7
+ '@esbuild/netbsd-x64': 0.27.7
+ '@esbuild/openbsd-arm64': 0.27.7
+ '@esbuild/openbsd-x64': 0.27.7
+ '@esbuild/openharmony-arm64': 0.27.7
+ '@esbuild/sunos-x64': 0.27.7
+ '@esbuild/win32-arm64': 0.27.7
+ '@esbuild/win32-ia32': 0.27.7
+ '@esbuild/win32-x64': 0.27.7
+
+
dependencies:
'@types/estree': 1.0.8
+
+
+ dependencies:
+ eventsource-parser: 3.1.0
+
+ dependencies:
+ express: 5.2.1
+ ip-address: 10.2.0
+
+ dependencies:
+ accepts: 2.0.0
+ body-parser: 2.3.0
+ content-disposition: 1.1.0
+ content-type: 1.0.5
+ cookie: 0.7.2
+ cookie-signature: 1.2.2
+ debug: 4.4.3
+ depd: 2.0.0
+ encodeurl: 2.0.0
+ escape-html: 1.0.3
+ etag: 1.8.1
+ finalhandler: 2.1.1
+ fresh: 2.0.0
+ http-errors: 2.0.1
+ merge-descriptors: 2.0.0
+ mime-types: 3.0.2
+ on-finished: 2.4.1
+ once: 1.4.0
+ parseurl: 1.3.3
+ proxy-addr: 2.0.7
+ qs: 6.15.2
+ range-parser: 1.2.1
+ router: 2.2.0
+ send: 1.2.1
+ serve-static: 2.2.1
+ statuses: 2.0.2
+ type-is: 2.1.0
+ vary: 1.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+
+
+
optionalDependencies:
picomatch: 4.0.3
+ optionalDependencies:
+ picomatch: 4.0.4
+
dependencies:
to-regex-range: 5.0.1
+ dependencies:
+ debug: 4.4.3
+ encodeurl: 2.0.0
+ escape-html: 1.0.3
+ on-finished: 2.4.1
+ parseurl: 1.3.3
+ statuses: 2.0.2
+ transitivePeerDependencies:
+ - supports-color
+
@@ -1879,6 +3224,10 @@ snapshots:
mime-types: 2.1.35
optional: true
+
+
optional: true
@@ -1898,13 +3247,11 @@ snapshots:
has-symbols: 1.1.0
hasown: 2.0.2
math-intrinsics: 1.1.0
- optional: true
dependencies:
dunder-proto: 1.0.1
es-object-atoms: 1.1.1
- optional: true
dependencies:
@@ -1919,8 +3266,9 @@ snapshots:
package-json-from-dist: 1.0.1
path-scurry: 1.11.1
- optional: true
+
dependencies:
@@ -1930,8 +3278,7 @@ snapshots:
- optional: true
dependencies:
@@ -1942,6 +3289,8 @@ snapshots:
dependencies:
function-bind: 1.1.2
+
dependencies:
whatwg-encoding: 3.1.1
@@ -1949,6 +3298,14 @@ snapshots:
+ dependencies:
+ depd: 2.0.0
+ inherits: 2.0.4
+ setprototypeof: 1.2.0
+ statuses: 2.0.2
+ toidentifier: 1.0.1
+
dependencies:
agent-base: 7.1.4
@@ -1970,6 +3327,16 @@ snapshots:
safer-buffer: 2.1.2
optional: true
+ dependencies:
+ safer-buffer: 2.1.2
+
+
+
+
dependencies:
binary-extensions: 2.3.0
@@ -1993,6 +3360,8 @@ snapshots:
optional: true
+
@@ -2026,6 +3395,8 @@ snapshots:
optionalDependencies:
'@pkgjs/parseargs': 0.11.0
+
optional: true
@@ -2058,6 +3429,65 @@ snapshots:
- utf-8-validate
optional: true
+
+
+ optional: true
+
+ optional: true
+
+ optional: true
+
+ optional: true
+
+ optional: true
+
+ optional: true
+
+ optional: true
+
+ optional: true
+
+ optional: true
+
+ optional: true
+
+ optional: true
+
+ dependencies:
+ detect-libc: 2.1.2
+ optionalDependencies:
+ lightningcss-android-arm64: 1.32.0
+ lightningcss-darwin-arm64: 1.32.0
+ lightningcss-darwin-x64: 1.32.0
+ lightningcss-freebsd-x64: 1.32.0
+ lightningcss-linux-arm-gnueabihf: 1.32.0
+ lightningcss-linux-arm64-gnu: 1.32.0
+ lightningcss-linux-arm64-musl: 1.32.0
+ lightningcss-linux-x64-gnu: 1.32.0
+ lightningcss-linux-x64-musl: 1.32.0
+ lightningcss-win32-arm64-msvc: 1.32.0
+ lightningcss-win32-x64-msvc: 1.32.0
+
+ dependencies:
+ mlly: 1.8.2
+ pkg-types: 2.3.1
+ quansync: 0.2.11
+
dependencies:
chalk: 5.6.2
@@ -2067,6 +3497,10 @@ snapshots:
+ dependencies:
+ react: 19.2.7
+
dependencies:
'@jridgewell/sourcemap-codec': 1.5.5
@@ -2081,17 +3515,26 @@ snapshots:
dependencies:
semver: 7.7.4
- optional: true
+
+
optional: true
+
dependencies:
mime-db: 1.52.0
optional: true
+ dependencies:
+ mime-db: 1.54.0
+
@@ -2106,17 +3549,40 @@ snapshots:
+ dependencies:
+ acorn: 8.17.0
+ pathe: 2.0.3
+ pkg-types: 1.3.1
+ ufo: 1.6.4
+
+
+
optional: true
+
+
+ dependencies:
+ ee-first: 1.1.1
+
+ dependencies:
+ wrappy: 1.0.2
+
dependencies:
mimic-function: 5.0.1
@@ -2140,6 +3606,8 @@ snapshots:
entities: 6.0.1
optional: true
+
@@ -2149,8 +3617,12 @@ snapshots:
lru-cache: 10.4.3
minipass: 7.1.2
+
+
@@ -2159,23 +3631,76 @@ snapshots:
+
+
+ dependencies:
+ confbox: 0.1.8
+ mlly: 1.8.2
+ pathe: 2.0.3
+
+ dependencies:
+ confbox: 0.2.4
+ exsolve: 1.0.8
+ pathe: 2.0.3
+
+ dependencies:
+ nanoid: 3.3.13
+ picocolors: 1.1.1
+ source-map-js: 1.2.1
+
dependencies:
nanoid: 3.3.11
picocolors: 1.1.1
source-map-js: 1.2.1
+
+ dependencies:
+ forwarded: 0.2.0
+ ipaddr.js: 1.9.1
+
optional: true
+ dependencies:
+ side-channel: 1.1.1
+
+
dependencies:
safe-buffer: 5.2.1
+
+ dependencies:
+ bytes: 3.1.2
+ http-errors: 2.0.1
+ iconv-lite: 0.7.2
+ unpipe: 1.0.0
+
+ dependencies:
+ react: 19.2.7
+ scheduler: 0.27.0
+
+
dependencies:
picomatch: 2.3.1
+
dependencies:
is-core-module: 2.16.1
@@ -2191,6 +3716,27 @@ snapshots:
dependencies:
glob: 10.5.0
+ dependencies:
+ '@oxc-project/types': 0.133.0
+ '@rolldown/pluginutils': 1.0.1
+ optionalDependencies:
+ '@rolldown/binding-android-arm64': 1.0.3
+ '@rolldown/binding-darwin-arm64': 1.0.3
+ '@rolldown/binding-darwin-x64': 1.0.3
+ '@rolldown/binding-freebsd-x64': 1.0.3
+ '@rolldown/binding-linux-arm-gnueabihf': 1.0.3
+ '@rolldown/binding-linux-arm64-gnu': 1.0.3
+ '@rolldown/binding-linux-arm64-musl': 1.0.3
+ '@rolldown/binding-linux-ppc64-gnu': 1.0.3
+ '@rolldown/binding-linux-s390x-gnu': 1.0.3
+ '@rolldown/binding-linux-x64-gnu': 1.0.3
+ '@rolldown/binding-linux-x64-musl': 1.0.3
+ '@rolldown/binding-openharmony-arm64': 1.0.3
+ '@rolldown/binding-wasm32-wasi': 1.0.3
+ '@rolldown/binding-win32-arm64-msvc': 1.0.3
+ '@rolldown/binding-win32-x64-msvc': 1.0.3
+
dependencies:
magic-string: 0.30.21
@@ -2230,6 +3776,16 @@ snapshots:
'@rollup/rollup-win32-x64-msvc': 4.57.1
fsevents: 2.3.3
+ dependencies:
+ debug: 4.4.3
+ depd: 2.0.0
+ is-promise: 4.0.0
+ parseurl: 1.3.3
+ path-to-regexp: 8.4.2
+ transitivePeerDependencies:
+ - supports-color
+
optional: true
@@ -2238,26 +3794,82 @@ snapshots:
- optional: true
dependencies:
xmlchars: 2.2.0
optional: true
+
+ dependencies:
+ debug: 4.4.3
+ encodeurl: 2.0.0
+ escape-html: 1.0.3
+ etag: 1.8.1
+ fresh: 2.0.0
+ http-errors: 2.0.1
+ mime-types: 3.0.2
+ ms: 2.1.3
+ on-finished: 2.4.1
+ range-parser: 1.2.1
+ statuses: 2.0.2
+ transitivePeerDependencies:
+ - supports-color
+
dependencies:
randombytes: 2.1.0
+ dependencies:
+ encodeurl: 2.0.0
+ escape-html: 1.0.3
+ parseurl: 1.3.3
+ send: 1.2.1
+ transitivePeerDependencies:
+ - supports-color
+
+
dependencies:
shebang-regex: 3.0.0
+ dependencies:
+ es-errors: 1.3.0
+ object-inspect: 1.13.4
+
+ dependencies:
+ call-bound: 1.0.4
+ es-errors: 1.3.0
+ get-intrinsic: 1.3.0
+ object-inspect: 1.13.4
+
+ dependencies:
+ call-bound: 1.0.4
+ es-errors: 1.3.0
+ get-intrinsic: 1.3.0
+ object-inspect: 1.13.4
+ side-channel-map: 1.0.1
+
+ dependencies:
+ es-errors: 1.3.0
+ object-inspect: 1.13.4
+ side-channel-list: 1.0.1
+ side-channel-map: 1.0.1
+ side-channel-weakmap: 1.0.2
+
@@ -2281,6 +3893,8 @@ snapshots:
+
@@ -2311,6 +3925,12 @@ snapshots:
dependencies:
ansi-regex: 6.2.2
+ dependencies:
+ debug: 4.4.3
+ transitivePeerDependencies:
+ - supports-color
+
dependencies:
has-flag: 4.0.0
@@ -2342,6 +3962,11 @@ snapshots:
fdir: 6.5.0([email protected])
picomatch: 4.0.3
+ dependencies:
+ fdir: 6.5.0([email protected])
+ picomatch: 4.0.4
+
@@ -2360,6 +3985,8 @@ snapshots:
dependencies:
is-number: 7.0.0
+
@@ -2374,18 +4001,36 @@ snapshots:
+ dependencies:
+ content-type: 2.0.0
+ media-typer: 1.1.0
+ mime-types: 3.0.2
+
+
+
+
+
optional: true
+
+
dependencies:
cac: 6.7.14
debug: 4.4.3
es-module-lexer: 1.7.0
pathe: 1.1.2
- vite: 5.4.21(@types/[email protected])([email protected])
transitivePeerDependencies:
- '@types/node'
- less
@@ -2397,20 +4042,42 @@ snapshots:
- supports-color
- terser
+
+ dependencies:
+ local-pkg: 1.2.1
+ optionalDependencies:
+ vite-plugin-electron-renderer: 1.0.0
+
dependencies:
esbuild: 0.21.5
postcss: 8.5.6
rollup: 4.57.1
optionalDependencies:
- '@types/node': 25.2.3
+ '@types/node': 25.9.3
+ fsevents: 2.3.3
+ lightningcss: 1.32.0
+ terser: 5.46.0
+
+ dependencies:
+ lightningcss: 1.32.0
+ picomatch: 4.0.4
+ postcss: 8.5.15
+ rolldown: 1.0.3
+ tinyglobby: 0.2.17
+ optionalDependencies:
+ '@types/node': 25.9.3
+ esbuild: 0.27.7
fsevents: 2.3.3
terser: 5.46.0
dependencies:
'@vitest/expect': 2.1.9
- '@vitest/mocker': 2.1.9([email protected](@types/[email protected])([email protected]))
'@vitest/pretty-format': 2.1.9
'@vitest/runner': 2.1.9
'@vitest/snapshot': 2.1.9
@@ -2426,11 +4093,11 @@ snapshots:
tinyexec: 0.3.2
tinypool: 1.1.1
tinyrainbow: 1.2.0
- vite: 5.4.21(@types/[email protected])([email protected])
- vite-node: 2.1.9(@types/[email protected])([email protected])
why-is-node-running: 2.3.0
optionalDependencies:
- '@types/node': 25.2.3
+ '@types/node': 25.9.3
'@vitest/ui': 2.1.9([email protected])
happy-dom: 15.11.7
jsdom: 25.0.1
@@ -2489,6 +4156,8 @@ snapshots:
string-width: 5.1.2
strip-ansi: 7.1.2
+
optional: true
@@ -2497,3 +4166,14 @@ snapshots:
optional: true
+
+ dependencies:
+ zod: 4.4.3
+
+
+ optionalDependencies:
+ '@types/react': 19.2.17
+ react: 19.2.7
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 1eca0e7ea..f9b6e0144 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -1,4 +1,6 @@
packages:
- 'sdk'
+ - 'desktop'
onlyBuiltDependencies:
- esbuild
+ - electron
diff --git a/sdk/src/app.ts b/sdk/src/app.ts
index 86f9e2fc7..f4d515b42 100644
--- a/sdk/src/app.ts
+++ b/sdk/src/app.ts
@@ -23,6 +23,7 @@ import { sceneManagerPlugin } from './scenePlugin';
import { getDefaultContext } from './context';
import { cameraPlugin } from './camera/CameraPlugin';
import { PhysicsRuntime } from './physics/PhysicsRuntime';
+import { SubsystemRegistry } from './subsystems';
import { log } from './logger';
// =============================================================================
@@ -74,6 +75,11 @@ export class App {
private fixedAccumulator_ = 0;
private maxDeltaTime_ = 0.25;
private maxFixedSteps_ = 8;
+ // Spiral-of-death guard: cap wall time spent on fixed-step catch-up per frame.
+ // A sim too heavy to run real-time (e.g. thousands of bodies) then degrades to
+ // slow motion instead of freezing — the frame stays responsive. The first step
+ // always runs (the check is after a step), so the sim always advances.
+ private fixedStepBudgetMs_ = 8;
private targetFrameInterval_ = 0;
private module_: ESEngineModule | null = null;
@@ -82,6 +88,8 @@ export class App {
private readonly installed_plugins_: Plugin[] = [];
private readonly installedPluginSet_ = new Set<Plugin>();
private readonly installedPluginNames_ = new Set<string>();
+ // Per-App (per-realm) so isolated realms never alias; not a shared resource default.
+ private readonly subsystems_ = new SubsystemRegistry();
private pluginsFinished_ = false;
private readonly eventRegistry_ = new EventRegistry();
private readonly sortedSystemsCache_ = new Map<Schedule, SystemEntry[]>();
@@ -117,6 +125,13 @@ export class App {
return this.installed_plugins_.find((p): p is T => p instanceof ctor);
}
+ /** Subsystem lifecycle registry ("which modules loaded/ready/stepping/errored").
+ * Named plugins auto-register in {@link addPlugin}; async plugins (physics)
+ * drive their own initializing→ready/error transitions. */
+ get subsystems(): SubsystemRegistry {
+ return this.subsystems_;
+ }
+
addPlugins(plugins: Plugin[]): this {
const sorted = this.sortPlugins(plugins);
for (const plugin of sorted) {
@@ -148,14 +163,27 @@ export class App {
this.installed_plugins_.push(plugin);
if (plugin.name) {
this.installedPluginNames_.add(plugin.name);
+ // Observable from frame zero; string deps give the status UI cascade context.
+ this.subsystems_.register(plugin.name, {
+ dependsOn: plugin.dependencies?.filter(
+ (d): d is string => typeof d === 'string',
+ ),
+ });
}
try {
plugin.build(this);
+ // Sync plugin: live once build() returns → promote. An async plugin
+ // (physics) already moved itself off `registered`, so this skips it.
+ if (plugin.name && this.subsystems_.phaseOf(plugin.name) === 'registered') {
+ this.subsystems_.transition(plugin.name, 'ready');
+ }
} catch (e) {
this.installedPluginSet_.delete(plugin);
this.installed_plugins_.pop();
if (plugin.name) {
this.installedPluginNames_.delete(plugin.name);
+ // Keep the errored (now-uninstalled) entry so the failure stays visible.
+ this.subsystems_.markError(plugin.name, e instanceof Error ? e.message : String(e));
}
throw e;
}
@@ -585,15 +613,26 @@ export class App {
this.fixedAccumulator_ += delta;
let fixedSteps = 0;
+ // Direct performance.now() (not platformNow) so the budget guard needs
+ // no platform init (unit tests call tick() without it) and degrades to a
+ // no-op where performance is absent — the maxFixedSteps cap still applies.
+ const perf = typeof performance !== 'undefined' && typeof performance.now === 'function' ? performance : null;
+ const fixedStart = perf ? perf.now() : 0;
while (this.fixedAccumulator_ >= this.fixedTimestep_ && fixedSteps < this.maxFixedSteps_) {
this.fixedAccumulator_ -= this.fixedTimestep_;
await this.runSchedule(Schedule.FixedPreUpdate);
await this.runSchedule(Schedule.FixedUpdate);
await this.runSchedule(Schedule.FixedPostUpdate);
fixedSteps++;
+ // Stop catching up once this frame's fixed steps blow the time
+ // budget — drop the backlog below so we don't spiral.
+ if (perf && perf.now() - fixedStart >= this.fixedStepBudgetMs_) break;
}
- if (fixedSteps >= this.maxFixedSteps_) {
- this.fixedAccumulator_ = this.fixedTimestep_;
+ // Hit the step cap or the time budget with a step still pending → the
+ // sim can't keep real-time; drop the backlog so the accumulator can't
+ // grow unbounded (graceful slow motion instead of a death spiral).
+ if (this.fixedAccumulator_ >= this.fixedTimestep_) {
+ this.fixedAccumulator_ = 0;
}
// Remainder fraction into the current fixed step — render-time systems
// (physics interpolation) lerp prev→current by this for smooth motion.
diff --git a/sdk/src/core-runtime.ts b/sdk/src/core-runtime.ts
index e0606b720..ca5857c71 100644
--- a/sdk/src/core-runtime.ts
+++ b/sdk/src/core-runtime.ts
@@ -271,6 +271,18 @@ export {
type WebAppOptions,
} from './app';
+// =============================================================================
+// Subsystem observability
+// =============================================================================
+
+export { SubsystemRegistry } from './subsystems';
+export type {
+ SubsystemStatus,
+ SubsystemPhase,
+ SubsystemActivity,
+ SubsystemEvent,
+} from './subsystems';
+
// =============================================================================
// WASM Types
// =============================================================================
diff --git a/sdk/src/ecs/ChangeTracker.ts b/sdk/src/ecs/ChangeTracker.ts
index ce8b5741d..f217912bb 100644
--- a/sdk/src/ecs/ChangeTracker.ts
+++ b/sdk/src/ecs/ChangeTracker.ts
@@ -12,6 +12,9 @@ export class ChangeTracker {
private componentChangedTicks_ = new Map<symbol, Map<Entity, number>>();
private componentRemovedBuffer_ = new Map<symbol, Array<{ entity: Entity; tick: number }>>();
private trackedComponents_ = new Set<symbol>();
+ // The most recent worldTick at which ANY entity changed each component — an
+ // O(1) "did anything change since tick T" gate (vs scanning the per-entity map).
+ private componentLastChangedTick_ = new Map<symbol, number>();
advanceTick(): void {
this.worldTick_++;
@@ -39,6 +42,12 @@ export class ChangeTracker {
return tick !== undefined && tick > sinceTick;
}
+ /** True if ANY entity changed `component` after `sinceTick`. O(1) — reads the
+ * per-component last-changed tick, not the per-entity map. */
+ anyChangedSince(component: AnyComponentDef, sinceTick: number): boolean {
+ return (this.componentLastChangedTick_.get(component._id) ?? -1) > sinceTick;
+ }
+
getRemovedEntitiesSince(component: AnyComponentDef, sinceTick: number): Entity[] {
const buffer = this.componentRemovedBuffer_.get(component._id);
if (!buffer) return [];
@@ -84,6 +93,7 @@ export class ChangeTracker {
this.componentChangedTicks_.set(component._id, map);
}
map.set(entity, this.worldTick_);
+ this.componentLastChangedTick_.set(component._id, this.worldTick_);
}
recordRemoved(component: AnyComponentDef, entity: Entity): void {
diff --git a/sdk/src/physics/PhysicsModuleLoader.ts b/sdk/src/physics/PhysicsModuleLoader.ts
index a28abb55e..556663402 100644
--- a/sdk/src/physics/PhysicsModuleLoader.ts
+++ b/sdk/src/physics/PhysicsModuleLoader.ts
@@ -196,7 +196,13 @@ export async function loadPhysicsModule(
}
export interface ESEngineMainModule {
- loadDynamicLibrary(binary: Uint8Array, opts: { loadAsync: boolean; allowUndefined: boolean }): Promise<void>;
+ // emscripten loads a side module BY NAME from the virtual FS — the first arg
+ // is a path string (it does isAbs(path).charAt(...)), never raw bytes.
+ loadDynamicLibrary(
+ libName: string,
+ flags?: { loadAsync?: boolean; allowUndefined?: boolean; global?: boolean; nodelete?: boolean },
+ ): Promise<void>;
+ FS: { writeFile(path: string, data: Uint8Array | string): void };
cwrap(name: string, returnType: string | null, argTypes: string[]): (...args: unknown[]) => unknown;
HEAPF32: Float32Array;
HEAPU8: Uint8Array;
@@ -209,10 +215,13 @@ export async function loadPhysicsSideModule(
wasmBinary: ArrayBuffer,
mainModule: ESEngineMainModule
): Promise<PhysicsWasmModule> {
- await mainModule.loadDynamicLibrary(
- new Uint8Array(wasmBinary),
- { loadAsync: true, allowUndefined: true }
- );
+ // Stage the fetched wasm into the virtual FS, then load it by path —
+ // loadDynamicLibrary can't take bytes directly. `global: true` merges the
+ // side module's exports into the main module's symbol table so cwrap can
+ // resolve `physics_*`.
+ const libPath = '/physics.wasm';
+ mainModule.FS.writeFile(libPath, new Uint8Array(wasmBinary));
+ await mainModule.loadDynamicLibrary(libPath, { loadAsync: true, allowUndefined: true, global: true });
const cwrap = mainModule.cwrap.bind(mainModule);
@@ -338,3 +347,57 @@ export async function loadPhysicsSideModule(
_free: mainModule._free.bind(mainModule),
} as PhysicsWasmModule;
}
+
+/**
+ * Fetch `physics.wasm` from `baseUrl` and load it into the running esengine
+ * module via its dynamic linker — the web/electron realm's loader (the wasm is
+ * an emscripten side module, no standalone glue). Null on fetch failure so
+ * callers degrade gracefully.
+ */
+/**
+ * Load the STANDALONE physics module (physics.js ESM factory + physics.wasm) from
+ * `baseUrl` and instantiate it — the web/editor realm's loader, mirroring how
+ * esengine.js is loaded. A self-contained emscripten module (no dynamic linking),
+ * so no ABI coupling to the engine; `_physics_*` are EMSCRIPTEN_KEEPALIVE-exported
+ * so they're directly callable on the returned module. Null on failure.
+ */
+export async function fetchPhysicsModule(baseUrl: string): Promise<PhysicsWasmModule | null> {
+ const base = baseUrl.replace(/\/$/, '');
+ try {
+ const glue = await import(/* @vite-ignore */ `${base}/physics.js`);
+ const factory = (glue.default ?? glue) as (
+ opts?: Record<string, unknown>,
+ ) => Promise<PhysicsWasmModule>;
+ return await factory({ locateFile: (p: string) => `${base}/${p}` });
+ } catch (e) {
+ console.error(`[physics] standalone module load failed (${base}/physics.js):`, e);
+ return null;
+ }
+}
+
+export async function fetchPhysicsSideModule(
+ baseUrl: string,
+ mainModule: ESEngineMainModule,
+): Promise<PhysicsWasmModule | null> {
+ const url = `${baseUrl.replace(/\/$/, '')}/physics.wasm`;
+ let res: Response;
+ try {
+ res = await fetch(url);
+ } catch (e) {
+ console.error(`[physics] side-module FETCH threw (${url}):`, e);
+ return null;
+ }
+ if (!res.ok) {
+ console.error(`[physics] side-module fetch HTTP ${res.status} (${url})`);
+ return null;
+ }
+ try {
+ const binary = await res.arrayBuffer();
+ const hasLoad = typeof (mainModule as { loadDynamicLibrary?: unknown }).loadDynamicLibrary === 'function';
+ console.info(`[physics] linking side-module: ${binary.byteLength}B, loadDynamicLibrary=${hasLoad}`);
+ return await loadPhysicsSideModule(binary, mainModule);
+ } catch (e) {
+ console.error(`[physics] side-module LINK failed (${url}):`, e);
+ return null;
+ }
+}
diff --git a/sdk/src/physics/PhysicsPlugin.ts b/sdk/src/physics/PhysicsPlugin.ts
index 64eae7f38..36a976656 100644
--- a/sdk/src/physics/PhysicsPlugin.ts
+++ b/sdk/src/physics/PhysicsPlugin.ts
@@ -92,9 +92,17 @@ export class PhysicsPlugin implements Plugin {
sensorExits: [],
});
app.insertResource(PhysicsRuntime, { module: null, initPromise: null });
+ // wasm loading → show "initializing", not a stuck "registered".
+ app.subsystems.transition('physics', 'initializing');
const initPromise = loadPhysicsModule(this.wasmUrl_, this.factory_).then(
(loaded: PhysicsWasmModule) => {
+ // Push a terminal Box2D abort to the registry too (not just the
+ // bridge's call-time guard). Set before connect() so the bridge's
+ // abort guard preserves and chains this handler.
+ (loaded as { onAbort?: (what: unknown) => void }).onAbort = () =>
+ app.subsystems.markError('physics', 'Box2D wasm module aborted');
+
// Route the module through the single WASM bridge: this installs
// the terminal-abort guard and yields a guarded view in which
// every `_physics_*` call short-circuits after an abort. The
@@ -127,10 +135,13 @@ export class PhysicsPlugin implements Plugin {
app.insertResource(PhysicsAPI, Physics._fromModule(module));
setupPhysicsDebugDraw(app, PhysicsAPI, PhysicsEvents);
app.setFixedTimestep(this.config_.fixedTimestep);
+ // Module loaded, world initialized, systems registered.
+ app.subsystems.transition('physics', 'ready');
},
);
initPromise.catch((e) => {
+ app.subsystems.markError('physics', e instanceof Error ? e.message : String(e));
handleWasmError(e, 'PhysicsPlugin.init');
});
app.getResource(PhysicsRuntime).initPromise = initPromise;
diff --git a/sdk/src/physics/PhysicsSystem.ts b/sdk/src/physics/PhysicsSystem.ts
index 9a31841d3..726e074ea 100644
--- a/sdk/src/physics/PhysicsSystem.ts
+++ b/sdk/src/physics/PhysicsSystem.ts
@@ -620,6 +620,16 @@ export function registerPhysicsSystem(
};
const fixedDt = config.fixedTimestep;
+ // Change-driven reconcile: track physics components so a value edit is an O(1)
+ // signal, letting the per-step reconcile skip the full entity scan in steady
+ // state (no structural change + no physics-component edit). Kinematic bodies
+ // are driven by their Transform, so they're tracked separately and pushed every
+ // step regardless of whether the reconcile ran.
+ const physicsComponents = [RigidBody, ...COLLIDER_TYPES, ...JOINT_TYPES];
+ for (const c of physicsComponents) app.world.enableChangeTracking(c);
+ const kinematicEntities = new Set<Entity>();
+ let lastStructuralVersion = -1;
+
const world = app.world;
world.onDespawn((entity: Entity) => {
@@ -632,6 +642,7 @@ export function registerPhysicsSystem(
trackedEntities.delete(entity);
cachedProps.delete(entity);
parentedBodies.delete(entity);
+ kinematicEntities.delete(entity);
snaps.prev.delete(entity);
snaps.cur.delete(entity);
}
@@ -645,6 +656,9 @@ export function registerPhysicsSystem(
defineSystem(
[],
() => {
+ // Watchdog beat: gated by playModeOnly, so a fresh beat means
+ // "physics is actually stepping" (vs loaded-but-frozen in edit mode).
+ app.subsystems.markStepped('physics');
// Read pixelsPerUnit live each tick so a Canvas property
// change at runtime (editor: user edits Canvas.pixelsPerUnit)
// propagates to physics transforms instead of staying at the
@@ -654,6 +668,21 @@ export function registerPhysicsSystem(
// Keep the query API's default scale in sync with the live Canvas,
// so raycast/overlap that omit `ppu` aren't silently scaled to 100.
if (app.hasResource(PhysicsAPI)) app.getResource(PhysicsAPI).setPixelsPerUnit(ppu);
+ // Steady-state fast path: skip the full entity reconcile unless
+ // something structural changed (spawn/despawn/add-remove component →
+ // structuralVersion) OR a physics component was edited (O(1) gate).
+ // Otherwise the bodies are simulated by Box2D + read back in bulk.
+ const structuralVersion = world.getWorldVersion();
+ let needReconcile = structuralVersion !== lastStructuralVersion;
+ if (!needReconcile) {
+ for (let i = 0; i < physicsComponents.length; i++) {
+ if (world.anyChangedSince(physicsComponents[i], lastEntitySyncTick)) {
+ needReconcile = true;
+ break;
+ }
+ }
+ }
+ if (needReconcile) {
const entities = world.getEntitiesWithComponents([RigidBody, Transform]);
const currentEntities = new Set<Entity>();
@@ -693,6 +722,7 @@ export function registerPhysicsSystem(
enabled: true,
colliderSig: colliderSignature(world, entity),
});
+ if (rb.bodyType === BodyType.Kinematic) kinematicEntities.add(entity);
continue;
}
@@ -735,15 +765,11 @@ export function registerPhysicsSystem(
cached.colliderSig = sig;
}
- // 4. kinematic bodies are driven directly from their Transform.
- if (cached.bodyType === BodyType.Kinematic) {
- const wt = world.get(entity, Transform) as TransformData;
- module._physics_setBodyTransform(
- entity,
- wt.worldPosition.x * invPpu, wt.worldPosition.y * invPpu,
- quatToAngleZ(wt.worldRotation),
- );
- }
+ // 4. kinematic bodies: maintain the set; the Transform→body push
+ // runs every step outside the (gated) reconcile so it survives
+ // skipped frames.
+ if (cached.bodyType === BodyType.Kinematic) kinematicEntities.add(entity);
+ else kinematicEntities.delete(entity);
}
// Bodies whose entity left the query without firing onDespawn.
@@ -753,6 +779,7 @@ export function registerPhysicsSystem(
trackedEntities.delete(entity);
cachedProps.delete(entity);
parentedBodies.delete(entity);
+ kinematicEntities.delete(entity);
}
}
@@ -768,6 +795,20 @@ export function registerPhysicsSystem(
createPendingJoints(world, module, trackedEntities, trackedJoints, invPpu);
lastEntitySyncTick = world.getWorldTick();
+ lastStructuralVersion = structuralVersion;
+ } // end if (needReconcile)
+
+ // Kinematic bodies are driven by their Transform (changed via gameplay,
+ // not tracked as a physics edit) — push every step, even when the
+ // reconcile above was skipped.
+ for (const entity of kinematicEntities) {
+ const wt = world.get(entity, Transform) as TransformData;
+ module._physics_setBodyTransform(
+ entity,
+ wt.worldPosition.x * invPpu, wt.worldPosition.y * invPpu,
+ quatToAngleZ(wt.worldRotation),
+ );
+ }
if (trackedEntities.size > 0) {
module._physics_step(fixedDt);
diff --git a/sdk/src/physics/index.ts b/sdk/src/physics/index.ts
index e6382f58f..3bd17614d 100644
--- a/sdk/src/physics/index.ts
+++ b/sdk/src/physics/index.ts
@@ -27,6 +27,8 @@ export {
export {
loadPhysicsModule,
loadPhysicsSideModule,
+ fetchPhysicsSideModule,
+ fetchPhysicsModule,
type PhysicsWasmModule,
type PhysicsModuleFactory,
type ESEngineMainModule,
diff --git a/sdk/src/playRealmRuntime.ts b/sdk/src/playRealmRuntime.ts
index 4b6079a63..f0b340326 100644
--- a/sdk/src/playRealmRuntime.ts
+++ b/sdk/src/playRealmRuntime.ts
@@ -17,6 +17,8 @@ import { initRuntime } from './runtimeLoader';
import type { RuntimeAssetProvider } from './runtimeLoader';
import type { AddressableManifest } from './asset/AddressableManifest';
import type { SceneData } from './scene';
+import { fetchPhysicsModule } from './physics';
+import type { Vec2 } from './types';
const UUID_PREFIX = '@uuid:';
@@ -29,6 +31,16 @@ export interface PlayRealmRuntimeConfig {
/** Lowercased uuid → fetchable URL (e.g. `estella://project/<path>`). */
assetManifest: Record<string, string>;
manifest?: AddressableManifest | null;
+ /** Base URL the engine side-modules (physics.wasm, …) are served from — same
+ * dir as esengine.wasm. When set, the realm can load physics on demand. */
+ wasmBaseUrl?: string;
+ /** Project-declared physics enable (`.uproject` features analog) — installs
+ * physics even for runtime-spawned bodies the static scene doesn't show. */
+ physicsEnabled?: boolean;
+ /** Optional physics world overrides (e.g. project-declared gravity). */
+ physicsGravity?: Vec2;
+ /** Turn on per-phase / per-system frame timing (editor profiler; off in shipped games). */
+ enableStats?: boolean;
}
/**
@@ -84,7 +96,7 @@ class FetchAssetProvider implements RuntimeAssetProvider {
* register the snapshot as the sole scene, wire a fetch-backed provider, and run.
*/
export async function initPlayRealmRuntime(config: PlayRealmRuntimeConfig): Promise<void> {
- const { app, module, canvas, sceneData, assetManifest, manifest } = config;
+ const { app, module, canvas, sceneData, assetManifest, manifest, wasmBaseUrl } = config;
const provider = new FetchAssetProvider(assetManifest);
await initRuntime({
app,
@@ -94,6 +106,13 @@ export async function initPlayRealmRuntime(config: PlayRealmRuntimeConfig): Prom
firstScene: '__play',
manifest: manifest ?? null,
aspectRatio: canvas.width / canvas.height,
+ physicsEnabled: config.physicsEnabled,
+ physicsConfig: config.physicsGravity ? { gravity: config.physicsGravity } : undefined,
+ // Load the standalone physics module (physics.js+wasm) on demand when gated in.
+ acquirePhysics: wasmBaseUrl ? () => fetchPhysicsModule(wasmBaseUrl) : undefined,
});
+ // Per-phase / per-system frame timing for the editor profiler (enabled before
+ // the loop starts so the runner instruments from frame zero).
+ if (config.enableStats) app.enableStats();
app.run();
}
diff --git a/sdk/src/runtimeLoader.ts b/sdk/src/runtimeLoader.ts
index fe1f53ded..4d1128f7b 100644
--- a/sdk/src/runtimeLoader.ts
+++ b/sdk/src/runtimeLoader.ts
@@ -318,12 +318,35 @@ export interface LoadRuntimeSceneOptions {
spineManager?: SpineManager | null;
physicsModule?: PhysicsWasmModule | null;
physicsConfig?: { gravity?: Vec2; fixedTimestep?: number; subStepCount?: number; contactHertz?: number; contactDampingRatio?: number; contactSpeed?: number };
+ /** Project-declared physics enable (`.uproject` features analog) — installs
+ * physics even for runtime-spawned bodies the static scene doesn't show.
+ * OR-combined with a content scan. */
+ physicsEnabled?: boolean;
+ /** Lazy, realm-specific side-module acquirer (play realm fetches physics.wasm);
+ * called only when gated in and no `physicsModule` was pre-supplied. */
+ acquirePhysics?: () => Promise<PhysicsWasmModule | null>;
manifest?: AddressableManifest | null;
sceneName?: string;
}
+/** Component types whose presence means a scene needs the physics subsystem. */
+const PHYSICS_COMPONENT_TYPES = new Set([
+ 'RigidBody', 'BoxCollider', 'CircleCollider', 'CapsuleCollider',
+ 'SegmentCollider', 'PolygonCollider', 'ChainCollider',
+]);
+
+/** True if any entity in the scene carries a physics component (content gate). */
+function sceneUsesPhysics(sceneData: SceneData): boolean {
+ for (const entity of sceneData.entities ?? []) {
+ for (const comp of entity.components ?? []) {
+ if (PHYSICS_COMPONENT_TYPES.has(comp.type)) return true;
+ }
+ }
+ return false;
+}
+
export async function loadRuntimeScene(options: LoadRuntimeSceneOptions): Promise<void> {
- const { app, module, sceneData, provider, spineManager, physicsModule, physicsConfig, manifest, sceneName } = options;
+ const { app, module, sceneData, provider, spineManager, physicsConfig, physicsEnabled, acquirePhysics, manifest, sceneName } = options;
const discovered = discoverSceneAssets(sceneData);
@@ -332,17 +355,32 @@ export async function loadRuntimeScene(options: LoadRuntimeSceneOptions): Promis
const spineAssetInfo = await loadSpineAssets(module, provider, spineManager, discovered.spines);
- if (physicsModule) {
- const config: PhysicsPluginConfig = {
- gravity: physicsConfig?.gravity ?? { ...DEFAULT_GRAVITY },
- fixedTimestep: physicsConfig?.fixedTimestep ?? DEFAULT_FIXED_TIMESTEP,
- subStepCount: physicsConfig?.subStepCount ?? 4,
- contactHertz: physicsConfig?.contactHertz ?? 120,
- contactDampingRatio: physicsConfig?.contactDampingRatio ?? 10,
- contactSpeed: physicsConfig?.contactSpeed ?? 10,
- };
- const physicsPlugin = new PhysicsPlugin('', config, () => Promise.resolve(physicsModule));
- physicsPlugin.build(app);
+ // Self-gating: install physics when the project declares it OR the scene uses
+ // it, so no runtime entry can forget to wire it. Module is pre-supplied
+ // (playable/wechat embed) or lazily acquired (play realm fetches side-module).
+ // Install once via addPlugin (also registers it in the observability surface).
+ let physicsModule = options.physicsModule ?? null;
+ const wantsPhysics = !!physicsEnabled || sceneUsesPhysics(sceneData);
+ if (!wantsPhysics) {
+ log.info('physics', 'not installed — not declared (features.physics) and scene has no physics components');
+ } else {
+ if (!physicsModule && acquirePhysics) physicsModule = await acquirePhysics();
+ if (!physicsModule) {
+ log.warn('physics', `wanted (declared=${!!physicsEnabled}) but no module loaded — side-module fetch/link failed or no provider for this realm`);
+ } else if (!app.getPlugin(PhysicsPlugin)) {
+ const gravity = physicsConfig?.gravity ?? { ...DEFAULT_GRAVITY };
+ const config: PhysicsPluginConfig = {
+ gravity,
+ fixedTimestep: physicsConfig?.fixedTimestep ?? DEFAULT_FIXED_TIMESTEP,
+ subStepCount: physicsConfig?.subStepCount ?? 4,
+ contactHertz: physicsConfig?.contactHertz ?? 120,
+ contactDampingRatio: physicsConfig?.contactDampingRatio ?? 10,
+ contactSpeed: physicsConfig?.contactSpeed ?? 10,
+ };
+ const mod = physicsModule;
+ app.addPlugin(new PhysicsPlugin('', config, () => Promise.resolve(mod)));
+ log.info('physics', `installed (gravity ${gravity.x}, ${gravity.y})`);
+ }
}
const fontCache = await loadBitmapFonts(module, provider, getAssetPathsByType(discovered, 'font'));
@@ -398,6 +436,10 @@ export interface RuntimeInitConfig {
spineManager?: SpineManager | null;
physicsModule?: PhysicsWasmModule | null;
physicsConfig?: { gravity?: Vec2; fixedTimestep?: number; subStepCount?: number; contactHertz?: number; contactDampingRatio?: number; contactSpeed?: number };
+ /** Project-declared physics enable; see {@link LoadRuntimeSceneOptions.physicsEnabled}. */
+ physicsEnabled?: boolean;
+ /** Lazy physics module acquirer; see {@link LoadRuntimeSceneOptions.acquirePhysics}. */
+ acquirePhysics?: () => Promise<PhysicsWasmModule | null>;
manifest?: AddressableManifest | null;
aspectRatio?: number;
}
@@ -415,6 +457,8 @@ export async function initRuntime(config: RuntimeInitConfig): Promise<void> {
spineManager: config.spineManager,
physicsModule: config.physicsModule,
physicsConfig: config.physicsConfig,
+ physicsEnabled: config.physicsEnabled,
+ acquirePhysics: config.acquirePhysics,
manifest: config.manifest,
};
diff --git a/sdk/src/subsystems.ts b/sdk/src/subsystems.ts
new file mode 100644
index 000000000..ee6495278
--- /dev/null
+++ b/sdk/src/subsystems.ts
@@ -0,0 +1,175 @@
+/**
+ * @file subsystems.ts
+ * @brief Per-App registry of engine subsystem lifecycle + liveness — the
+ * observability seam for "which modules are loaded, ready, stepping, or
+ * errored".
+ *
+ * @details Phase (registered → initializing → ready, error terminal) is recorded;
+ * each transition appends a timestamped event for history. Liveness is
+ * derived, not stored: an owned system pets the watchdog via
+ * markStepped() each tick; getStatuses() reports `stepping` while beats
+ * are fresh, `idle` once stale (e.g. physics frozen by playModeOnly in
+ * edit mode) — the load≠run distinction. One registry per realm, never a
+ * shared singleton, so realms report independently.
+ */
+
+/** Wall clock for beat/age math; degrades to 0 where performance is absent. */
+function nowMs(): number {
+ return typeof performance !== 'undefined' && typeof performance.now === 'function'
+ ? performance.now()
+ : 0;
+}
+
+/** Beats older than this (ms) read as stopped — bridges a ~33ms fixed step +
+ * editor sampling, yet flips to `idle` promptly on pause. */
+const STEP_STALE_MS = 400;
+
+/** Bound on retained lifecycle events (a diagnostics tail, not full history). */
+const EVENT_LOG_CAP = 128;
+
+/** Recorded lifecycle phases. `stepping` / `idle` are derived, not phases. */
+export type SubsystemPhase = 'registered' | 'initializing' | 'ready' | 'error';
+
+/** Runtime liveness, derived from watchdog beats at read time. */
+export type SubsystemActivity = 'stepping' | 'idle' | 'inactive';
+
+/** One recorded lifecycle transition. */
+export interface SubsystemEvent {
+ readonly id: string;
+ readonly phase: SubsystemPhase;
+ readonly detail?: string;
+ /** performance.now() at emit, for ordering and age. */
+ readonly atMs: number;
+ /** Monotonic emit counter — stable order even across equal timestamps. */
+ readonly seq: number;
+}
+
+/** A subsystem's current status, with liveness derived at read time. */
+export interface SubsystemStatus {
+ readonly id: string;
+ readonly displayName: string;
+ readonly phase: SubsystemPhase;
+ readonly activity: SubsystemActivity;
+ /** Latest phase detail (e.g. an error message). */
+ readonly detail?: string;
+ /** The last error reason, retained even after later transitions. */
+ readonly lastError?: string;
+ /** Plugin names this subsystem declared a dependency on (cascade context). */
+ readonly dependsOn: readonly string[];
+ /** How long the current phase has been held, in ms. */
+ readonly phaseAgeMs: number;
+}
+
+interface Entry {
+ id: string;
+ displayName: string;
+ phase: SubsystemPhase;
+ detail?: string;
+ lastError?: string;
+ dependsOn: string[];
+ phaseSinceMs: number;
+ lastBeatMs: number;
+}
+
+export class SubsystemRegistry {
+ private readonly entries_ = new Map<string, Entry>();
+ /** Insertion order, so the UI lists subsystems install-order stably. */
+ private readonly order_: string[] = [];
+ private readonly events_: SubsystemEvent[] = [];
+ private readonly listeners_ = new Set<() => void>();
+ private seq_ = 0;
+
+ /** Register (or re-register) a subsystem in the `registered` phase. */
+ register(id: string, opts: { displayName?: string; dependsOn?: string[] } = {}): void {
+ let e = this.entries_.get(id);
+ if (!e) {
+ e = {
+ id,
+ displayName: opts.displayName ?? id,
+ phase: 'registered',
+ dependsOn: opts.dependsOn ?? [],
+ phaseSinceMs: nowMs(),
+ lastBeatMs: 0,
+ };
+ this.entries_.set(id, e);
+ this.order_.push(id);
+ } else {
+ if (opts.displayName) e.displayName = opts.displayName;
+ if (opts.dependsOn) e.dependsOn = opts.dependsOn;
+ e.phase = 'registered';
+ e.phaseSinceMs = nowMs();
+ e.lastError = undefined;
+ }
+ this.emit_(id, 'registered');
+ }
+
+ /** Move a subsystem to a new lifecycle phase (no-op for an unknown id). */
+ transition(id: string, phase: SubsystemPhase, detail?: string): void {
+ const e = this.entries_.get(id);
+ if (!e) return;
+ e.phase = phase;
+ e.detail = detail;
+ e.phaseSinceMs = nowMs();
+ if (phase === 'error') e.lastError = detail ?? e.lastError;
+ this.emit_(id, phase, detail);
+ }
+
+ /** Terminal error transition; keeps the reason in `lastError`. */
+ markError(id: string, reason?: string): void {
+ this.transition(id, 'error', reason);
+ }
+
+ /** The current phase of a subsystem, or undefined if unknown. */
+ phaseOf(id: string): SubsystemPhase | undefined {
+ return this.entries_.get(id)?.phase;
+ }
+
+ /** Pet the watchdog: an owned system ran this frame. Cheap and silent (no
+ * notify) — liveness is sampled, not pushed. Call once per tick. */
+ markStepped(id: string): void {
+ const e = this.entries_.get(id);
+ if (e) e.lastBeatMs = nowMs();
+ }
+
+ /** Current status of every subsystem, install order, liveness derived now. */
+ getStatuses(): SubsystemStatus[] {
+ const t = nowMs();
+ return this.order_.map((id) => {
+ const e = this.entries_.get(id)!;
+ // Never-beat → `inactive` (liveness unknown), not a misleading `idle`.
+ let activity: SubsystemActivity = 'inactive';
+ if (e.phase === 'ready' && e.lastBeatMs > 0) {
+ activity = t - e.lastBeatMs <= STEP_STALE_MS ? 'stepping' : 'idle';
+ }
+ return {
+ id: e.id,
+ displayName: e.displayName,
+ phase: e.phase,
+ activity,
+ detail: e.detail,
+ lastError: e.lastError,
+ dependsOn: e.dependsOn.slice(),
+ phaseAgeMs: t - e.phaseSinceMs,
+ };
+ });
+ }
+
+ /** Recent lifecycle transitions, oldest→newest (for a diagnostics log). */
+ recentEvents(limit = EVENT_LOG_CAP): SubsystemEvent[] {
+ return limit >= this.events_.length ? this.events_.slice() : this.events_.slice(-limit);
+ }
+
+ /** Subscribe to phase transitions (not per-beat). Returns an unsubscribe. */
+ subscribe(fn: () => void): () => void {
+ this.listeners_.add(fn);
+ return () => {
+ this.listeners_.delete(fn);
+ };
+ }
+
+ private emit_(id: string, phase: SubsystemPhase, detail?: string): void {
+ this.events_.push({ id, phase, detail, atMs: nowMs(), seq: ++this.seq_ });
+ if (this.events_.length > EVENT_LOG_CAP) this.events_.shift();
+ for (const fn of this.listeners_) fn();
+ }
+}
diff --git a/sdk/src/world.ts b/sdk/src/world.ts
index e3e671fa7..0f879ef24 100644
--- a/sdk/src/world.ts
+++ b/sdk/src/world.ts
@@ -755,6 +755,11 @@ export class World {
return this.changes_.isChangedSince(entity, component, sinceTick);
}
+ /** True if ANY entity changed `component` after `sinceTick` (O(1) gate). */
+ anyChangedSince(component: AnyComponentDef, sinceTick: number): boolean {
+ return this.changes_.anyChangedSince(component, sinceTick);
+ }
+
getRemovedEntitiesSince(component: AnyComponentDef, sinceTick: number): Entity[] {
return this.changes_.getRemovedEntitiesSince(component, sinceTick);
}
diff --git a/sdk/tests/subsystems.test.ts b/sdk/tests/subsystems.test.ts
new file mode 100644
index 000000000..d3ec9a973
--- /dev/null
+++ b/sdk/tests/subsystems.test.ts
@@ -0,0 +1,119 @@
+import { describe, it, expect, vi } from 'vitest';
+import { SubsystemRegistry } from '../src/subsystems';
+import { App, type Plugin } from '../src/app';
+
+describe('SubsystemRegistry', () => {
+ it('registers in the registered phase, in install order, inactive', () => {
+ const r = new SubsystemRegistry();
+ r.register('physics', { displayName: 'Physics' });
+ r.register('audio');
+ const s = r.getStatuses();
+ expect(s.map((x) => x.id)).toEqual(['physics', 'audio']);
+ expect(s[0].phase).toBe('registered');
+ expect(s[0].displayName).toBe('Physics');
+ expect(s[0].activity).toBe('inactive');
+ });
+
+ it('transitions registered → initializing → ready', () => {
+ const r = new SubsystemRegistry();
+ r.register('physics');
+ r.transition('physics', 'initializing');
+ expect(r.phaseOf('physics')).toBe('initializing');
+ r.transition('physics', 'ready');
+ expect(r.phaseOf('physics')).toBe('ready');
+ });
+
+ it('a ready subsystem is inactive until pet, then stepping (load≠run)', () => {
+ const r = new SubsystemRegistry();
+ r.register('physics');
+ r.transition('physics', 'ready');
+ expect(r.getStatuses()[0].activity).toBe('inactive'); // never beat
+ r.markStepped('physics');
+ expect(r.getStatuses()[0].activity).toBe('stepping'); // fresh beat
+ });
+
+ it('derives idle once the watchdog beat goes stale', () => {
+ const now = vi.spyOn(performance, 'now');
+ now.mockReturnValue(1000);
+ const r = new SubsystemRegistry();
+ r.register('physics');
+ r.transition('physics', 'ready');
+ r.markStepped('physics');
+ now.mockReturnValue(1000 + 500); // beyond STEP_STALE_MS (400ms)
+ expect(r.getStatuses()[0].activity).toBe('idle');
+ now.mockRestore();
+ });
+
+ it('markError records a terminal error and retains the reason', () => {
+ const r = new SubsystemRegistry();
+ r.register('physics');
+ r.markError('physics', 'wasm aborted');
+ const s = r.getStatuses()[0];
+ expect(s.phase).toBe('error');
+ expect(s.lastError).toBe('wasm aborted');
+ expect(s.activity).toBe('inactive');
+ });
+
+ it('keeps dependency context and an ordered transition event log', () => {
+ const r = new SubsystemRegistry();
+ r.register('spine', { dependsOn: ['engineCore'] });
+ r.transition('spine', 'ready');
+ expect(r.getStatuses()[0].dependsOn).toEqual(['engineCore']);
+ const ev = r.recentEvents();
+ expect(ev.map((e) => e.phase)).toEqual(['registered', 'ready']);
+ expect(ev[0].id).toBe('spine');
+ });
+
+ it('notifies subscribers on transition but not on markStepped', () => {
+ const r = new SubsystemRegistry();
+ r.register('physics');
+ let n = 0;
+ const off = r.subscribe(() => { n++; });
+ r.transition('physics', 'ready'); // +1
+ r.markStepped('physics'); // silent
+ expect(n).toBe(1);
+ off();
+ r.transition('physics', 'error'); // no notify after unsubscribe
+ expect(n).toBe(1);
+ });
+});
+
+describe('App auto-registers plugin lifecycle into the subsystem registry', () => {
+ it('promotes a synchronous plugin to ready once build() returns', () => {
+ const app = App.new();
+ const core: Plugin = { name: 'core', build() {} };
+ app.addPlugin(core);
+ expect(app.subsystems.phaseOf('core')).toBe('ready');
+ });
+
+ it('leaves an async plugin in the phase it set for itself', () => {
+ const app = App.new();
+ // Mirrors PhysicsPlugin: moves itself off `registered` during build, so
+ // the App must NOT auto-promote it — it reaches ready on its own later.
+ const phys: Plugin = {
+ name: 'phys',
+ build(a) { a.subsystems.transition('phys', 'initializing'); },
+ };
+ app.addPlugin(phys);
+ expect(app.subsystems.phaseOf('phys')).toBe('initializing');
+ });
+
+ it('records a build() throw as a visible terminal error', () => {
+ const app = App.new();
+ const bad: Plugin = { name: 'bad', build() { throw new Error('boom'); } };
+ expect(() => app.addPlugin(bad)).toThrow('boom');
+ const s = app.subsystems.getStatuses().find((x) => x.id === 'bad');
+ expect(s?.phase).toBe('error');
+ expect(s?.lastError).toContain('boom');
+ // The failed plugin is rolled back from install but stays observable.
+ expect(app.getPlugin(class {} as never)).toBeUndefined();
+ });
+
+ it('captures string dependencies as cascade context', () => {
+ const app = App.new();
+ app.addPlugin({ name: 'a', build() {} });
+ app.addPlugin({ name: 'b', dependencies: ['a'], build() {} });
+ const b = app.subsystems.getStatuses().find((x) => x.id === 'b');
+ expect(b?.dependsOn).toEqual(['a']);
+ });
+});