Function runAddPowerupCommand

src/register/queue_display_commands.ts:39–95

(plugin: ReactRNPlugin, powerup: string)

        user; on confirm, apply to the parent instead. (Applied to the current
        card itself these would make the card vanish — almost always wrong.)
      - For all other powerups → apply directly to the current card.
   2. If invoked outside the queue → apply to the editor selection. */
async function runAddPowerupCommand(plugin: ReactRNPlugin, powerup: string) {
  const url = await plugin.window.getURL();
  const currentCard = await plugin.queue.getCurrentCard();
  const sel = await plugin.editor.getSelection();
  const selType = sel?.type;

  if (url.includes('/flashcards') && currentCard) {
    let isTargetingCurrentCard = false;
    if (!selType) {
      isTargetingCurrentCard = true;
    } else if (selType === SelectionType.Rem && sel.remIds.includes(currentCard.remId)) {
      isTargetingCurrentCard = true;
    } else if (selType === SelectionType.Text && sel.remId === currentCard.remId) {
      isTargetingCurrentCard = true;
    }

    if (isTargetingCurrentCard) {
      if (SELF_HIDING_POWERUPS.has(powerup)) {
        const powerupName = POWERUP_DISPLAY_NAMES[powerup];
        const userConfirmed = window.confirm(
          `Warning: "${powerupName}" is meant for parent/ancestor Rems, not the flashcard directly.\n\n` +
          `Click "OK" to navigate to the parent Rem and apply the powerup there, or "Cancel" to abort.\n\n` +
          `Consider these alternatives if you want to affect ONLY this flashcard, not other descendants from the same ancestor:\n` +
          `  "Hide Parent" / "Hide Grandparent"\n` +
          `  "Remove Parent" / "Remove Grandparent"\n\n`
        );
        if (userConfirmed) {
          const rem = await plugin.rem.findOne(currentCard.remId);
          const parent = await rem?.getParentRem();
          if (parent) {
            await parent.addPowerup(powerup);
            await plugin.app.toast(`Applied "${powerupName}" to parent.`);
          } else {
            await plugin.app.toast('Could not find a parent Rem.');
          }
        }
      } else {
        const rem = await plugin.rem.findOne(currentCard.remId);
        await rem?.addPowerup(powerup);
        await plugin.app.toast(
          'Powerup added (will take effect next time you see this card).'
        );
      }
      return;
    }
  }

  // Outside the queue: apply to editor selection.
  if (!selType) return;
  if (selType === SelectionType.Rem) {
    const rems = (await plugin.rem.findMany(sel.remIds)) || [];
    rems.forEach((r) => r.addPowerup(powerup));
  } else {
    const rem = await plugin.rem.findOne(sel.remId);
    rem?.addPowerup(powerup);
  }