OneBot: Leantime 改造版源码（BOM/Univer 表格/AI 接管/品牌替换等）

app/Core/Controller/HxComponent.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Leantime\Core\Controller;
+
+use Leantime\Core\Events\Htmx\HtmxEvent;
+
+/**
+ * Base class for HTMX-backed components.
+ *
+ * An HxComponent is an {@see HtmxController} that also declares its event contract — the route it
+ * is fetched from, the events that should make it re-fetch ({@see listensTo}), and the events it
+ * emits when its actions mutate data ({@see emits}). The `<x-global::hx :for="...::class">` mount
+ * component reads this contract to auto-wire `hx-get`/`hx-trigger`, so the emit side and the listen
+ * side reference the SAME enum case and can never drift apart (the class of bug where a template
+ * listens for `subtasksUpdated` while the controller emits `subtasks_update`).
+ *
+ * Plain {@see HtmxController}s remain valid; declaring the contract is opt-in. Components that don't
+ * extend this can still be mounted with explicit `endpoint`/`listen` attributes on `<x-global::hx>`.
+ *
+ * @method string|null run() Inherited fallback action.
+ */
+abstract class HxComponent extends HtmxController
+{
+    /** The action invoked when the component is first mounted (its "render me" endpoint). */
+    public static string $mountAction = 'get';
+
+    /** Default `hx-swap` strategy for the mount wrapper. */
+    public static string $swap = 'outerHTML';
+
+    /**
+     * The hx route segment, e.g. "tickets/timerButton" → /hx/tickets/timerButton/{action}.
+     */
+    abstract public static function route(): string;
+
+    /**
+     * Events that should cause this component to re-fetch itself.
+     *
+     * @return array<int, HtmxEvent>
+     */
+    public static function listensTo(): array
+    {
+        return [];
+    }
+
+    /**
+     * Events this component emits when its actions mutate data (contract/documentation; the actual
+     * emission happens via {@see \Leantime\Core\UI\Template::emit()} inside the action methods).
+     *
+     * @return array<int, HtmxEvent>
+     */
+    public static function emits(): array
+    {
+        return [];
+    }
+}