import type { ParsedGsap } from "@hyperframes/core/gsap-parser";
import type { Composition } from "@hyperframes/sdk";
import type { DomEditSelection } from "../components/editor/domEditingTypes";
import type { EditHistoryKind } from "../utils/editHistory";
import type { RuntimeTweenChange } from "./gsapRuntimePatch";

export interface MutationResult {
  ok: boolean;
  changed?: boolean;
  parsed?: ParsedGsap;
  before?: string;
  after?: string;
  scriptText?: string;
}

export interface CommitMutationOptions {
  label: string;
  coalesceKey?: string;
  softReload?: boolean;
  skipReload?: boolean;
  beforeReload?: () => void;
  /**
   * Serialize this commit against others sharing the same key. Used to chain
   * per-animationId GSAP meta updates so overlapping read-modify-write POSTs to
   * one file can't interleave — which would pair the shadow fidelity diff with a
   * stale server result and report false ease mismatches. Commits without a key
   * (and under distinct keys) run concurrently as before.
   */
  serializeKey?: string;
  /**
   * Value-only edit fast path. When present, `runCommit` first tries to patch the
   * one changed tween in the preview's runtime timeline in place
   * (`patchRuntimeTweenInPlace`) — instant, no composition re-run, no iframe
   * remount. On a successful patch the reload is skipped entirely (panels still
   * refresh); when the patch can't be confidently applied it falls back to the
   * existing soft/full reload path. Structural edits omit this and reload as before.
   */
  instantPatch?: { selector: string; change: RuntimeTweenChange };
}

export type CommitMutation = (
  selection: DomEditSelection,
  mutation: Record<string, unknown>,
  options: CommitMutationOptions,
) => Promise<void>;

export type SafeGsapCommitMutation = (
  selection: DomEditSelection,
  mutation: Record<string, unknown>,
  options: CommitMutationOptions,
) => Promise<void>;

export type TrackGsapSaveFailure = (
  error: unknown,
  selection: DomEditSelection,
  mutation: Record<string, unknown>,
  label?: string,
) => void;

export interface GsapScriptCommitsParams {
  projectIdRef: React.MutableRefObject<string | null>;
  activeCompPath: string | null;
  previewIframeRef: React.RefObject<HTMLIFrameElement | null>;
  editHistory: {
    recordEdit: (entry: {
      label: string;
      kind: EditHistoryKind;
      coalesceKey?: string;
      files: Record<string, { before: string; after: string }>;
    }) => Promise<void>;
  };
  domEditSaveTimestampRef: React.MutableRefObject<number>;
  reloadPreview: () => void;
  onCacheInvalidate: () => void;
  onFileContentChanged?: (path: string, content: string) => void;
  showToast: (message: string, tone?: "error" | "info") => void;
  /** Stage 7 §3.5: SDK session for routing GSAP tween ops through addGsapTween/setGsapTween/removeGsapTween. */
  sdkSession?: Composition | null;
  writeProjectFile?: (path: string, content: string) => Promise<void>;
  /** Resync the in-memory SDK session after a server-authoritative write. */
  forceReloadSdkSession?: () => void;
}