afnm-types 0.6.55-injecttest → 0.6.55-injecttest2

package/dist/mod.d.ts

@@ -2462,20 +2462,22 @@ export interface ModAPI {
     /**
      * Inject UI into a named slot (dialog title or screen name).
      *
-     * The generator receives (api, element, inject):
+     * The generator receives (api, inject):
      * - api: full ModReduxAPI with game state, actions, and components
-     * - element: root DOM element of the slot; use querySelector to find children
-     * - inject(selector, content, placement?): helper to portal content relative to the element
-     *   matched by selector. placement controls where content appears (see InjectPlacement).
-     *   Defaults to 'after' (sibling inserted after the target).
+     * - inject(selector, content, placement?): places content relative to the matched element.
+     *   selector can be:
+     *     ''           the slot root itself
+     *     '#my-id'     find by id
+     *     '.a .b > .c' find by path (searched within the slot root)
+     *     someElement  a direct HTMLElement reference
+     *   placement controls where content appears (see InjectPlacement). Defaults to 'after'.
      *
      * Slot names for dialogs are the id (e.g. 'combat-victory'). You can find these by inspecting the DOM in dev mode.
      * Slot names for screens match the ScreenType value (e.g. 'combat').
      *
      * @example
-     * // Add a button after an element in the combat victory dialog
-     * modAPI.ui.injectUI('combat-victory', (api, element, inject) => {
-     *   return inject('[aria-live="assertive"]',
+     * modAPI.ui.injectUI('combat-victory', (api, inject) => {
+     *   inject('[aria-live="assertive"]',
      *     <api.components.GameButton onClick={() => api.actions.changeQi(100)}>
      *       Absorb Qi
      *     </api.components.GameButton>,
@@ -2483,7 +2485,7 @@ export interface ModAPI {
      *   );
      * });
      */
-    injectUI: (slotName: string, generator: (api: ModReduxAPI, element: HTMLElement | null, inject: (selector: string, content: React.ReactNode, placement?: InjectPlacement) => React.ReactNode) => React.ReactNode) => void;
+    injectUI: (slotName: string, generator: (api: ModReduxAPI, inject: (selector: string | HTMLElement, content: React.ReactNode, placement?: InjectPlacement) => void) => void) => void;
     /**
      * Subscribe to any Redux state changes. The callback receives the new state.
      * Returns an unsubscribe function.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afnm-types",
-  "version": "0.6.55-injecttest",
+  "version": "0.6.55-injecttest2",
   "description": "Type definitions for Ascend From Nine Mountains",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",