Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

2.3 KB
Raw Blame
"use client";

import { createContext, useContext } from "react";
import type { ReadingAgeMode } from "@/lib/reading-age-presentation";
import type {
  ReadingExtensionManifest,
  ReadingExtensionResult,
} from "@/lib/reading-api";

/** One runnable extension action, with its label already resolved. */
export interface ReadingActionEntry {
  key: string;
  extension: ReadingExtensionManifest;
  action: ReadingExtensionManifest["actions"][number];
  label: string;
  /** Needs a text selection to mean anything (translate, explain, guide). */
  needsSelection: boolean;
}

/**
 * One run of an action, as the companion column shows it.
 *
 * A card exists from the moment the action starts, so the learner sees where
 * the answer is going to land before it arrives — the old toolbar spun a chip
 * and then dropped a result between the toolbar and the page, a place nothing
 * else on screen ever used.
 */
export interface ReadingActionCard {
  id: string;
  key: string;
  label: string;
  quote: string;
  locator: number;
  materialId: string;
  status: "running" | "done" | "error";
  result?: ReadingExtensionResult;
  error?: string;
}

export interface ReadingActionsValue {
  ageMode: ReadingAgeMode;
  actions: ReadingActionEntry[];
  cards: ReadingActionCard[];
  speaking: boolean;
  /** Key of the action currently running, or "". */
  busyKey: string;
  run: (
    entry: ReadingActionEntry,
    target?: { locator?: number; selection?: string },
  ) => Promise<void>;
  stopSpeaking: () => void;
  dismiss: (cardId: string) => void;
}

export const ReadingActionsContext = createContext<ReadingActionsValue | null>(
  null,
);

/**
 * The workspace's shared reading actions, or `null` outside a workspace.
 *
 * `null` is a real state: the reader pane is also rendered on its own (tests,
 * and any host without a companion column), and there it keeps its own
 * toolbar with inline results.
 */
export function useReadingActions(): ReadingActionsValue | null {
  return useContext(ReadingActionsContext);
}

/**
 * Put the caret in the companion's composer, leaving its draft alone.
 *
 * The composer's own prefill hook *sets* the text, so using it with "" to
 * "just focus" wiped whatever the learner had half-typed.
 */
export function focusReadingComposer() {
  document
    .querySelector<HTMLTextAreaElement>("[data-reading-composer] textarea")
    ?.focus();
}