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.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
feat(physics+editor): standalone physics in the editor, scale perf, subsystem observability
esengineeba32e17eb66
diff --git a/CMakeLists.txt b/CMakeLists.txtindex 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.jsindex 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.jsindex 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.cmakeindex 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.tsindex 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.tsindex 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`, exporteddiff --git a/desktop/src/engine/EngineHost.ts b/desktop/src/engine/EngineHost.tsindex 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/cameradiff --git a/desktop/src/engine/PlayInspect.ts b/desktop/src/engine/PlayInspect.tsindex 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.tsindex 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.tsindex 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.tsxindex 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.tsxnew file mode 100644index 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.tsxindex 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/SceneQueryimport { 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.tsxindex 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.tsindex 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.tsindex 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). Fordiff --git a/desktop/src/project/format.ts b/desktop/src/project/format.tsindex 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.tsindex 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.tsnew file mode 100644index 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.cssindex 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.jsondeleted file mode 100644index 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.esprojectindex 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.yamlindex a2980a5c8..bcffb5c6a 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -21,6 +21,70 @@ importers:specifier: ^8.0.0version: 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+ version: 2.1.9(@types/[email protected])(@vitest/[email protected])([email protected])([email protected])([email protected])([email protected])+sdk:devDependencies:'@rollup/plugin-terser':@@ -58,7 +122,7 @@ importers:version: 5.9.3vitest:specifier: ^2.1.0- version: 2.1.9(@types/[email protected])(@vitest/[email protected])([email protected])([email protected])([email protected])+ version: 2.1.9(@types/[email protected])(@vitest/[email protected])([email protected])([email protected])([email protected])([email protected])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==}++ '@hono/[email protected]':+ 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==}+'@pkgjs/[email protected]':resolution: {integrity: sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==}engines: {node: '>=14'}@@ -290,6 +558,104 @@ packages:'@polka/[email protected]':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==}+'@types/[email protected]':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]': {}++ '@hono/[email protected]([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]': {}'@rollup/[email protected]([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++ '@types/[email protected](@types/[email protected])':+ dependencies:+ '@types/react': 19.2.17++ '@types/[email protected]':+ dependencies:+ csstype: 3.2.3++ '@vitejs/[email protected]([email protected](@types/[email protected])([email protected])([email protected]))':+ dependencies:+ '@rolldown/pluginutils': 1.0.1'@vitest/[email protected]([email protected])':dependencies:@@ -1595,7 +2762,7 @@ snapshots:std-env: 3.10.0test-exclude: 7.0.2tinyrainbow: 1.2.0- vitest: 2.1.9(@types/[email protected])(@vitest/[email protected])([email protected])([email protected])([email protected])+ vitest: 2.1.9(@types/[email protected])(@vitest/[email protected])([email protected])([email protected])([email protected])([email protected])transitivePeerDependencies:- supports-color@@ -1606,13 +2773,13 @@ snapshots:chai: 5.3.3tinyrainbow: 1.2.0+ '@vitest/[email protected]([email protected](@types/[email protected])([email protected])([email protected]))':dependencies:'@vitest/spy': 2.1.9estree-walker: 3.0.3magic-string: 0.30.21optionalDependencies:- vite: 5.4.21(@types/[email protected])([email protected])'@vitest/[email protected]':dependencies:@@ -1642,7 +2809,7 @@ snapshots:sirv: 3.0.2tinyglobby: 0.2.15tinyrainbow: 1.2.0- vitest: 2.1.9(@types/[email protected])(@vitest/[email protected])([email protected])([email protected])([email protected])+ vitest: 2.1.9(@types/[email protected])(@vitest/[email protected])([email protected])([email protected])([email protected])([email protected])'@vitest/[email protected]':dependencies:@@ -1650,11 +2817,29 @@ snapshots:loupe: 3.2.1tinyrainbow: 1.2.0+ dependencies:+ mime-types: 3.0.2+ negotiator: 1.0.0++ [email protected]: {}+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:+ [email protected]: {}+dependencies:es-errors: 1.3.0function-bind: 1.1.2- optional: true++ dependencies:+ call-bind-apply-helpers: 1.0.2+ get-intrinsic: 1.3.0dependencies:@@ -1748,6 +2953,25 @@ snapshots:+ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ 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.0optional: true+ [email protected]: {}+dependencies:whatwg-mimetype: 4.0.0@@ -1778,38 +3004,59 @@ snapshots:optional: true+ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ dockview-core: 6.6.1+ react: 19.2.7+dependencies:call-bind-apply-helpers: 1.0.2es-errors: 1.3.0gopd: 1.2.0- optional: true+ [email protected]: {}++ dependencies:+ '@electron-internal/extract-zip': 1.0.3+ '@electron/get': 5.0.0+ '@types/node': 24.13.2+ transitivePeerDependencies:+ - supports-color++ [email protected]: {}+optional: true- optional: true+ [email protected]: {}- optional: true+ [email protected]: {}++ [email protected]: {}dependencies:es-errors: 1.3.0- optional: truedependencies:@@ -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++ [email protected]: {}+dependencies:'@types/estree': 1.0.8+ [email protected]: {}++ [email protected]: {}++ 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++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}+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.35optional: true+ [email protected]: {}++ [email protected]: {}+optional: true@@ -1898,13 +3247,11 @@ snapshots:has-symbols: 1.1.0hasown: 2.0.2math-intrinsics: 1.1.0- optional: truedependencies:dunder-proto: 1.0.1es-object-atoms: 1.1.1- optional: truedependencies:@@ -1919,8 +3266,9 @@ snapshots:package-json-from-dist: 1.0.1path-scurry: 1.11.1- optional: true+ [email protected]: {}++ [email protected]: {}dependencies:@@ -1930,8 +3278,7 @@ snapshots:- optional: true+ [email protected]: {}dependencies:@@ -1942,6 +3289,8 @@ snapshots:dependencies:function-bind: 1.1.2+ [email protected]: {}+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.2optional: true+ dependencies:+ safer-buffer: 2.1.2++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}+dependencies:binary-extensions: 2.3.0@@ -1993,6 +3360,8 @@ snapshots:optional: true+ [email protected]: {}+@@ -2026,6 +3395,8 @@ snapshots:optionalDependencies:'@pkgjs/parseargs': 0.11.0+ [email protected]: {}+optional: true@@ -2058,6 +3429,65 @@ snapshots:- utf-8-validateoptional: true+ [email protected]: {}++ [email protected]: {}++ 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+ [email protected]: {}++ [email protected]: {}++ [email protected]: {}optional: true+ [email protected]: {}+dependencies:mime-db: 1.52.0optional: 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++ [email protected]: {}++ [email protected]: {}+optional: true+ [email protected]: {}++ [email protected]: {}++ 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.1optional: true+ [email protected]: {}+@@ -2149,8 +3617,12 @@ snapshots:lru-cache: 10.4.3minipass: 7.1.2+ [email protected]: {}++ [email protected]: {}+@@ -2159,23 +3631,76 @@ snapshots:+ [email protected]: {}++ [email protected]: {}++ 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.11picocolors: 1.1.1source-map-js: 1.2.1+ [email protected]: {}++ dependencies:+ forwarded: 0.2.0+ ipaddr.js: 1.9.1+optional: true+ dependencies:+ side-channel: 1.1.1++ [email protected]: {}+dependencies:safe-buffer: 5.2.1+ [email protected]: {}++ 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++ [email protected]: {}+dependencies:picomatch: 2.3.1+ [email protected]: {}+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.1fsevents: 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+ [email protected]: {}dependencies:xmlchars: 2.2.0optional: true+ [email protected]: {}++ 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++ [email protected]: {}+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:+ [email protected]: {}+@@ -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+ [email protected]: {}+@@ -2374,18 +4001,36 @@ snapshots:+ dependencies:+ content-type: 2.0.0+ media-typer: 1.1.0+ mime-types: 3.0.2++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}+optional: true+ [email protected]: {}++ [email protected]: {}+dependencies:cac: 6.7.14debug: 4.4.3es-module-lexer: 1.7.0pathe: 1.1.2- vite: 5.4.21(@types/[email protected])([email protected])transitivePeerDependencies:- '@types/node'- less@@ -2397,20 +4042,42 @@ snapshots:- supports-color- terser+ [email protected]: {}++ dependencies:+ local-pkg: 1.2.1+ optionalDependencies:+ vite-plugin-electron-renderer: 1.0.0+dependencies:esbuild: 0.21.5postcss: 8.5.6rollup: 4.57.1optionalDependencies:- '@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.7fsevents: 2.3.3terser: 5.46.0- [email protected](@types/[email protected])(@vitest/[email protected])([email protected])([email protected])([email protected]):+ [email protected](@types/[email protected])(@vitest/[email protected])([email protected])([email protected])([email protected])([email protected]):dependencies:'@vitest/expect': 2.1.9+ '@vitest/mocker': 2.1.9([email protected](@types/[email protected])([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.2tinypool: 1.1.1tinyrainbow: 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.0optionalDependencies:- '@types/node': 25.2.3+ '@types/node': 25.9.3'@vitest/ui': 2.1.9([email protected])happy-dom: 15.11.7jsdom: 25.0.1@@ -2489,6 +4156,8 @@ snapshots:string-width: 5.1.2strip-ansi: 7.1.2+ [email protected]: {}+optional: true@@ -2497,3 +4166,14 @@ snapshots:optional: true++ dependencies:+ zod: 4.4.3++ [email protected]: {}++ optionalDependencies:+ '@types/react': 19.2.17+ react: 19.2.7diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yamlindex 1eca0e7ea..f9b6e0144 100644--- a/pnpm-workspace.yaml+++ b/pnpm-workspace.yaml@@ -1,4 +1,6 @@packages:- 'sdk'+ - 'desktop'onlyBuiltDependencies:- esbuild+ - electrondiff --git a/sdk/src/app.ts b/sdk/src/app.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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): PromfirstScene: '__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.tsindex 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): Promisconst 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.tsnew file mode 100644index 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.tsindex 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.tsnew file mode 100644index 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']);+ });+});