Skip to content

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

1.7 KB
Raw Blame
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
/**
 * @file    ui/controller/plugin.ts
 * @brief   UIControllerPlugin — wires the controller/gear systems.
 *
 * Runs the `$interaction` driver after the hit-test has written UIInteraction,
 * then the gear-apply pass after the driver so a pointer-driven page change lands
 * the same frame. Neither system is play-gated: in edit mode the driver is inert
 * (no UIInteraction is written outside play), while gear-apply still reflects each
 * controller's authored `current` page — that is the editor's live preview.
 */
import type { App, Plugin } from '../../app/app';
import { Schedule } from '../../ecs/system';
import { SystemLabel } from '../../ecs/systemLabels';
import { createGearApplySystem, createInteractionControllerDriverSystem } from './gear-apply';
import { ensureControllerAiRegistrations } from './ai-builtins';

export class UIControllerPlugin implements Plugin {
    name = 'uiController';
    readonly profileDomain = 'ui';

    build(app: App): void {
        // Register the `.esfsm`/`.esbt` → controller glue (idempotent) so a
        // data-driven state machine can drive `ui.setPage`.
        ensureControllerAiRegistrations();

        app.addSystemToSchedule(
            Schedule.Update,
            createInteractionControllerDriverSystem(app.world),
            { runAfter: [SystemLabel.UIInteraction] },
        );
        app.addSystemToSchedule(
            Schedule.Update,
            createGearApplySystem(app.world),
            { runAfter: ['InteractionControllerDriverSystem'] },
        );
    }
}

export const uiControllerPlugin = new UIControllerPlugin();